Private Facts is a web app to track your private info.
This repo holds the source code and resource files for the project described at private-facts.readthedocs.io The code intends to be a demonstration of how to use Tahoe-lafs and better understand the concept of "provider-independent privacy" as it pertains to Tahoe-lafs.
There are several ways you can use this repo:
- as a companion to the tutorials at private-facts.readthedocs.io
- as the starting point for a project of your own
- as a practical guide to setting up a local development instance of Tahoe-lafs
We encourage you to read through the docs first and get an overall sense of the narrative arc. Later, if you want the hands-on experience, clone the repo and go through the instructions.
If you have never created a dev environment for Tahoe-lafs, do not follow these instructions before completing the tutorial. These instructions assume you know how the various subsystems work. If you follow the tutorials, we expect you to arrive at your destination qith fewer delays.
git clone https://github.com/blaisep/private_facts.git && cd private_factsuv venv
source .venv/bin/activate
uv pip install -r pyproject.tomlgrid-manager --config ./gm0 createInitiate Tahoe-LAFS servers (one introducer, two storage servers and a client server, each in a separate terminal window):
.venv/bin/tahoe create-introducer \
--listen=tcp --port=6001 \
--location=tcp:localhost:6001 ./introducer \
.venv/bin/tahoe -d introducer run$ .venv/bin/tahoe create-node --introducer $(cat introducer/private/introducer.furl) \
--nickname storage0 \
--webport 6101 -\
-location tcp:localhost:6102 \
--port 6102 \
./storage0The second you will call storage1, notice that the traffic is running on a different TCP port:
$ .venv/bin/tahoe create-node --introducer $(cat introducer/private/introducer.furl) \
--nickname storage1 \
--webport 6201 \
--location tcp:localhost:6202 \
--port 6202 ./storage1
Now, start each of the two storage servers. Pro tip: run them in separate terminal windows so that you can easily see the console output.
$ .venv/bin/tahoe -d storage0 run
$ .venv/bin/tahoe -d storage1 run
Add the storage servers to the local grid and create certificates:
$ grid-manager --config ./gm0 add storage1 $(cat storage1/node.pubkey)
$ grid-manager --config ./gm0 sign storage0 > ./storage0/gridmanager.cert 30
$ grid-manager --config ./gm0 sign storage1 > ./storage1/gridmanager.cert 30
$ grid-manager --config ./gm0 add storage0 $(cat storage0/node.pubkey)Edit storage servers to make them announce their certificates to the grid.
Edit the tahoe.cfg file in storage0 and storage1 to include these changes:
[storage]
grid_management = true
[grid_manager_certificates]
default = gridmanager.certNow, re-start storage servers.
$ .venv/bin/tahoe create-client --introducer $(cat introducer/private/introducer.furl) \
--nickname webapp --webport 6301 \
--shares-total=3 \
--shares-needed=2 \
--shares-happy=3 \
./webapp
$ .venv/bin/tahoe -d webapp runTo work with the TypeScript implmentation, install SvelteKit
- NodeJs > 20.0
- Pnpm
cd packages
pnpm install
pnpm dev --openThe project issue tracker is getting migrated. For now, feel free to open an issue and let us know how to improve.
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
Please make sure to update tests as appropriate.
We manage the project with uv, you don't have to.
GNU General Public License v3 //: # ( This file was inspired by https://www.makeareadme.com/ )