A step-by-step guide takes you from a free Sia Storage account to a working S3 key. Pithos opens the approval page for you and carries on by itself the moment you approve.
In Theseus, Pithos opens with your vault PIN. Three wrong tries and Theseus asks for your master password instead. Lock the vault and Pithos locks with it.
Create a user per app or person. Issue and revoke keys, and copy ready-made config for the aws CLI, rclone or environment variables.
Create a user per app or person. Issue and revoke keys, copy ready-made config for the aws CLI, rclone or environment variables, and save keys to an encrypted file protected by a password or your Theseus vault.
See which Sia account your storage runs on and give it a name. Switch to another account any time: the old one's users, keys and buckets are set aside on your computer, never deleted, and restore with one click.
Browse any user's buckets, drag files in, download them, delete folders, and make a bucket public-read when you want to serve files.
Signed links that work without a key and expire after an hour, a day or a week.
See what is still buffered locally, what is already on Sia, and anything that failed. Flush the buffer on demand.
Pithos is free and open source. Storage is billed by your Sia indexer, for example sia.storage.
v0.2.0 or newer. Pithos offers to install the right one for you and tells you when yours is too old.
Yes. Pithos uses the same config file a hand-run s3d uses. If s3d is already running, Pithos shows it as external, reads its stats and leaves the process alone.
The Sia account (for example on sia.storage) pays for the space; your s3d is connected to one. S3 users are logins on your own s3d, each with its own access keys, so you can give an app its own key and revoke it alone. A bucket is a top-level storage container, like a drive, owned by one user; folders inside it are just part of each file's name.
Yes, under Sia connection › Switch Sia account. s3d connects to the new account and starts empty. The previous account keeps its files, and its users, keys and buckets are set aside on your computer so you can restore them later. Pithos warns you first if uploads are still on their way to Sia.
After three wrong tries Theseus asks for your master password, which always works. You can set a new PIN any time in Theseus Settings › Passwords.
Uploads from the Pithos window are capped at 5 GiB per file for now. S3 clients such as aws and rclone use multipart uploads and go well beyond that.
A pithos was the great storage jar of the ancient Greek world, where a household kept what it could not afford to lose.