From c7576c726cb407dca3f0e31edb5b001bd93d9553 Mon Sep 17 00:00:00 2001 From: Local Dev Date: Sun, 4 Oct 2026 16:11:35 +0200 Subject: [PATCH] pithos.sia docs: drives on Silent Mode are open, with public folders at navigate.st/s3 The docs said hosting on Silent Mode was not open yet. It is now: a section explains moving s3d to s3.silentmode.st, the encryption, the sharing a plain s3d cannot do, signing up with a BNS name, and public folders at navigate.st/s3////. --- docs/index.html | 8 ++++++-- docs/pithos-docs.md | 13 ++++++++++++- 2 files changed, 18 insertions(+), 3 deletions(-) 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

  • In Theseus, the full page lives at pithos.sia/<user>/<drive>/<folder> (and pithos.sia/settings, pithos.sia/account …). The bare pithos.sia is this website.
  • 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/<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

-
  • 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.
+
  • 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.
  • 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

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

  • s3d v0.2.0+, S3 API on 127.0.0.1:8000, admin API on 127.0.0.1:8001 (Basic auth, empty user, adminPassword), region us-east-1, path-style addressing.
  • Setup order: s3d config → s3d login (indexer URL + 12-word phrase, approve the "S3d" app at the indexer) → run s3d → s3d users create → s3d keys create → use any S3 client.
  • Small files wait locally until a ~40 MB block fills; s3d flush or POST /objects/flush uploads them now.
  • Buckets ("drives") can be private, public read, or public read + list; nothing finer.
  • Config lookup: S3D_CONFIG_FILE, else the OS default path listed above.
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