<title>Pithos — a control panel for your Sia storage</title>
<metaname="description"content="Pithos runs s3d, the Sia S3 gateway, for you: connect it to Sia, create S3 users and keys, browse and share buckets, and watch uploads land on the network. In Theseus, on the desktop, or in a browser.">
<h1>Your own S3, <spanclass="g">stored on Sia</span></h1>
<pclass="tag">Pithos runs <ahref="https://github.com/SiaFoundation/s3d">s3d</a>, the Sia Foundation's S3 gateway, without the command line. Connect it to Sia, hand out access keys, manage buckets and watch your files reach the network.</p>
<divclass="cta">
<aclass="btn primary"href="#get">Get Pithos</a>
<aclass="btn"href="#how">How it works</a>
</div>
<divclass="shot"aria-hidden="true">
<divclass="bar"><i></i><i></i><i></i></div>
<divclass="body">
<nav><spanclass="on">Overview</span><span>Buckets</span><span>Users & keys</span><span>Sia connection</span><span>Settings</span><span>Logs</span></nav>
<pclass="lead">s3d is a great piece of plumbing that you drive with a CLI and config files. Pithos keeps the plumbing and gives you the controls.</p>
<divclass="grid">
<divclass="card"><divclass="ic">🔗</div><h3>Connect to Sia</h3><p>Register with sia.storage or your own indexer using your recovery phrase, or generate a new one. You approve the connection in your browser; the phrase never leaves your machine.</p></div>
<divclass="card"><divclass="ic">🔑</div><h3>Users & access keys</h3><p>Create a user per app or person. Issue and revoke keys, and copy ready-made config for the aws CLI, rclone or environment variables.</p></div>
<divclass="card"><divclass="ic">🗂️</div><h3>Buckets & files</h3><p>Browse any user's buckets, drag files in, download them, delete folders, and make a bucket public-read when you want to serve files.</p></div>
<divclass="card"><divclass="ic">📤</div><h3>Share links</h3><p>Signed links that work without a key and expire after an hour, a day or a week.</p></div>
<divclass="card"><divclass="ic">📈</div><h3>Upload pipeline</h3><p>See what is still buffered locally, what is already on Sia, and anything that failed. Flush the buffer on demand.</p></div>
<divclass="card"><divclass="ic">⚙️</div><h3>Daemon & settings</h3><p>Install the official s3d release with its checksum verified, start and stop it, follow its logs and edit its settings, including redundancy and upload threads.</p></div>
</div>
</div>
</section>
<sectionid="how">
<divclass="wrap">
<h2>How it works</h2>
<pclass="lead">Your apps talk plain S3. s3d encrypts and erasure-codes the data and spreads it across independent Sia hosts. Pithos sits beside s3d and runs it for you.</p>
<divclass="flow">
<divclass="node"><b>Your apps</b><small>aws, rclone, backups, any S3 SDK</small></div>
<divclass="arr">→</div>
<divclass="node s3d"><b>s3d</b><small>S3 API on your machine · encrypts locally</small></div>
<divclass="arr">→</div>
<divclass="node sia"><b>Sia network</b><small>independent hosts, 3× redundancy by default</small></div>
</div>
<divclass="ctl"><b>Pithos</b> starts and watches s3d, holds the Sia connection, issues keys and shows you the pipeline.</div>
<pclass="lead"style="margin-top:1.4rem">Files are encrypted before they leave your computer. Sia hosts store pieces they cannot read, and no single host holds enough to rebuild a file.</p>
</div>
</section>
<sectionid="get">
<divclass="wrap">
<h2>Three ways to run it</h2>
<pclass="lead">The same Pithos everywhere: one engine, one interface, three homes.</p>
<pclass="lead">A storage control panel holds the keys to your data, so Pithos is strict by default.</p>
<ulclass="checks">
<li><b>Your recovery phrase stays local.</b> It goes straight to the s3d process on your machine and is never stored, logged or uploaded.</li>
<li><b>Loopback only by default.</b> The control panel listens on 127.0.0.1 and rejects requests that arrive under any other host name.</li>
<li><b>One-time sign-in.</b> Theseus and the desktop app open the panel with a single-use secret that becomes a strict, HttpOnly session cookie.</li>
<li><b>No cross-site tricks.</b> Every change needs a custom header that other websites cannot send.</li>
<li><b>Verified downloads.</b> s3d binaries are checked against the Sia Foundation's published SHA-256 before they are installed.</li>
<li><b>Untrusted files stay inert.</b> Downloads are served sandboxed, so a stored HTML file cannot run inside the panel.</li>
</ul>
</div>
</section>
<sectionid="faq">
<divclass="wrap">
<h2>Questions</h2>
<detailsclass="faq"><summary>Is Pithos a storage provider?</summary><p>No. Pithos is a control panel. Your data goes from s3d on your machine straight to Sia hosts, paid through your indexer account. Silent Mode never sees or holds your files.</p></details>
<detailsclass="faq"><summary>What does it cost?</summary><p>Pithos is free and open source. Storage is billed by your Sia indexer, for example sia.storage.</p></details>
<detailsclass="faq"><summary>Which s3d version do I need?</summary><p>v0.2.0 or newer. Pithos offers to install the right one for you and tells you when yours is too old.</p></details>
<detailsclass="faq"><summary>I already run s3d as a service. Can Pithos manage it?</summary><p>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.</p></details>
<detailsclass="faq"><summary>Is there a size limit?</summary><p>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.</p></details>
<detailsclass="faq"><summary>Why the name?</summary><p>A pithos was the great storage jar of the ancient Greek world, where a household kept what it could not afford to lose.</p></details>
</div>
</section>
<footer>
<divclass="wrap cols">
<div>
<h4>pithos.sia</h4>
<pstyle="margin:.4rem 0 0;max-width:320px">A control panel for s3d, the Sia S3 gateway. Part of Silent Mode.</p>
<divclass="wrap"style="margin-top:1.6rem">s3d is MIT-licensed software by the Sia Foundation. Pithos is an independent, MPL-2.0 Silent Mode project and is not made by the Sia Foundation.</div>
