diff --git a/docs/index.html b/docs/index.html index 736b441..ca0f6a5 100644 --- a/docs/index.html +++ b/docs/index.html @@ -66,7 +66,7 @@ Markdown ↓
- +

Pithos documentation

Using an AI assistant? Give it this page or the Markdown version, then describe what you want to do. Type recovery phrases and secret keys only into s3d or Pithos on your own computer, never into a chat.
@@ -97,6 +97,10 @@

Live output of s3d and Pithos's own notes (why it started or did not start s3d, flushes, errors).

Addresses, updates and the lock

+

Drives on Silent Mode

+

By default s3d runs on your computer. Settings › Where your drives live can move it to Silent Mode's server (s3.silentmode.st) instead. It keeps working with your computer off, other devices can reach it, and the Pithos screens stay the same.

+ +

Public folders anyone can open. Make a folder public (⋯ › Share… on a drive on Silent Mode) and it gets an address like https://navigate.st/s3/<your-bns-name>/<drive>/<folder>/: a page with its files, small pictures and a player, which works in any browser. A single file is at the same address plus its name. Tools can add ?json to a folder address for a JSON listing.

Other ways to run Pithos

Web console

npm install
@@ -175,7 +179,7 @@ rclone copy ./photos s3d:my-drive/photos --progress

Troubleshooting

What you seeWhat it means / what to do
"N files waiting to upload", or "0 B on Sia"Files are still in the local buffer. Click Upload now (or s3d flush); automatic upload does it after 10 quiet minutes.
s3d "stopped" or "crashed"Overview › Start; read Logs for the reason. "Not registered" means s3d login has not been done for this config.
A link with 127.0.0.1 does not open elsewhereExpected: it points to the computer running s3d.
SignatureDoesNotMatch in an S3 appWrong secret, or the app uses virtual-host style; switch to path-style and region us-east-1.
"address already in use"Another program (or another s3d) uses port 8000/8001; change apiAddress/adminAddress or stop the other one.
Pithos shows "external"Another s3d is already running for this config; Pithos reads its stats but leaves it alone.
Pithos is lockedYour Theseus vault is locked; Unlock asks for the PIN.
A different account than expectedThe account is the indexer login plus the phrase. Accounts › Which Sia account this is shows the account key; compare it on sia.storage under My apps › S3d.

Limits

- +

For AI assistants

You are helping someone run s3d (the Sia S3 gateway), optionally through Pithos. Facts to rely on:

diff --git a/docs/pithos-docs.md b/docs/pithos-docs.md index bb4632f..916bd43 100644 --- a/docs/pithos-docs.md +++ b/docs/pithos-docs.md @@ -88,6 +88,17 @@ Live output of s3d and Pithos's own notes (why it started or did not start s3d, - The footer shows the version. ↻ checks for updates; a newer version shows as "↑ vX". Click it to install; recent Theseus versions apply it without a restart, older ones offer a restart. - When the vault locks, Pithos locks too; Unlock asks for your PIN. +## Drives on Silent Mode + +By default s3d runs on your computer. Settings › **Where your drives live** can move it to Silent Mode's server (`s3.silentmode.st`) instead. It keeps working with your computer off, other devices can reach it, and the Pithos screens stay the same. + +- **Still your own Sia account.** Only s3d's data folder (its database and the files still waiting) moves; nothing already on Sia is uploaded again, and the recovery phrase never leaves your computer. Moving back works the same way. +- **Encrypted before it leaves.** Pithos encrypts file names and contents on your computer, with keys from your Theseus vault (or a key file beside `s3d.yml` that you should back up). +- **Sharing a plain s3d cannot do.** Public folders, expiring share links, and S3 keys for other people limited to one folder with read, add-only or edit rights. Shared files are stored readable, because the people they are for have no key; stop sharing and Pithos encrypts them again. +- **Signing up** needs a signature from the wallet that owns a BNS name: one hosted account per name. + +**Public folders anyone can open.** Make a folder public (⋯ › Share… on a drive on Silent Mode) and it gets an address like `https://navigate.st/s3////`: a page with its files, small pictures and a player, which works in any browser. A single file is at the same address plus its name. Tools can add `?json` to a folder address for a JSON listing. + ## Other ways to run Pithos ### Web console @@ -265,7 +276,7 @@ rclone copy ./photos s3d:my-drive/photos --progress - Public access is per drive, read-only for others; s3d has no folder-level rules or write rights for other people. - Single uploads are capped at 5 GiB (multipart uploads from S3 tools work for larger files). - Share links and public files reach other people only when s3d has a public address. -- Running s3d on Silent Mode's server ("On Silent Mode", with encryption in the browser and folder-level sharing) is built into Pithos but the service is not open yet. +- Folder-level sharing and rights for other people need drives on Silent Mode (see that section); a plain s3d cannot do them. ## For AI assistants