pithos.sia: Linux downloads

The desktop card and docs now link the Linux AppImage, .deb and tar.gz,
say what the AppImage needs (FUSE 2), and explain that Pithos keeps s3d in
the home folder on Linux when the system paths are not writable.
This commit is contained in:
Local Dev 2026-10-04 23:04:55 +02:00
parent 3220a2461f
commit 660cbb8463
3 changed files with 20 additions and 4 deletions

View file

@ -109,7 +109,12 @@ node bin/pithos-web.js</code></pre>
<div class="table"><table><thead><tr><th>Flag</th><th>Meaning</th></tr></thead><tbody><tr><td><code>--listen host:port</code></td><td>Address to serve on (default <code>127.0.0.1:8700</code>). Anything beyond loopback needs a password.</td></tr><tr><td><code>--config &lt;s3d.yml&gt;</code></td><td>Which s3d config to manage.</td></tr><tr><td><code>--s3d &lt;binary&gt;</code></td><td>Use this s3d binary.</td></tr><tr><td><code>--bin-dir &lt;dir&gt;</code></td><td>Where Pithos installs s3d.</td></tr><tr><td><code>--password-file &lt;file&gt;</code></td><td>Password login (or set <code>PITHOS_PASSWORD</code>, at least 12 characters).</td></tr><tr><td><code>--allow-host &lt;name[:port]&gt;</code></td><td>Extra Host names allowed (behind a reverse proxy). Repeatable.</td></tr></tbody></table></div>
<p>Remote access: <code>PITHOS_PASSWORD='long random secret' node bin/pithos-web.js --listen 0.0.0.0:8700 --allow-host pithos.example.org</code>, behind a TLS reverse proxy.</p>
<h3 id="desktop-app"><a class="anchor" href="#desktop-app" aria-hidden="true">#</a>Desktop app</h3>
<p>Windows: <a href="https://dl.silentmode.st/latest/Pithos-Setup.exe">installer</a> or <a href="https://dl.silentmode.st/latest/Pithos-portable.exe">portable exe</a> (SHA-256 sums in <a href="https://dl.silentmode.st/releases-manifest.json">releases-manifest.json</a> under <code>pithos-desktop</code>). The builds are not code-signed yet, so Windows SmartScreen may ask you to confirm with More info › Run anyway. macOS and Linux builds are not published yet; run it from source:</p>
<p>Windows: <a href="https://dl.silentmode.st/latest/Pithos-Setup.exe">installer</a> or <a href="https://dl.silentmode.st/latest/Pithos-portable.exe">portable exe</a> (SHA-256 sums in <a href="https://dl.silentmode.st/releases-manifest.json">releases-manifest.json</a> under <code>pithos-desktop</code>). The builds are not code-signed yet, so Windows SmartScreen may ask you to confirm with More info › Run anyway.</p>
<p>Linux (x86-64): <a href="https://dl.silentmode.st/latest/Pithos.AppImage">AppImage</a>, <a href="https://dl.silentmode.st/latest/Pithos.deb">.deb</a> for Debian and Ubuntu, or <a href="https://dl.silentmode.st/latest/Pithos-linux-x64.tar.gz">tar.gz</a>.</p>
<pre class="code" data-lang="bash"><button class="copy" type="button" aria-label="Copy">Copy</button><code>chmod +x Pithos-*.AppImage &amp;&amp; ./Pithos-*.AppImage # needs FUSE 2 (libfuse2 / libfuse2t64 on Ubuntu)
sudo apt install ./Pithos-*-amd64.deb # then start Pithos from the app menu</code></pre>
<p>On Linux, s3d's own defaults (<code>/etc/s3d/s3d.yml</code>, <code>/var/lib/s3d</code>) are for a system service. When those do not exist and you cannot write there, Pithos keeps s3d in your home folder instead: <code>~/.config/s3d/s3d.yml</code> and <code>~/.local/share/s3d</code>. A hand-run s3d finds that config with <code>S3D_CONFIG_FILE=~/.config/s3d/s3d.yml</code>.</p>
<p>macOS builds are not published yet; run it from source:</p>
<pre class="code" data-lang="bash"><button class="copy" type="button" aria-label="Copy">Copy</button><code>npm install
npm run desktop</code></pre>
<p>The window signs itself in, installs s3d into its own folder (<code>%APPDATA%\pithos\bin</code> on Windows) and stops s3d when you quit. The version in the footer turns into "↑ vX" when a newer build is out; click it to download that build, then run it to update. Build the installers yourself with <code>npm run dist:win</code> (or <code>dist:linux</code> / <code>dist:mac</code> on those systems).</p>

View file

@ -123,7 +123,18 @@ Remote access: `PITHOS_PASSWORD='long random secret' node bin/pithos-web.js --li
### Desktop app
Windows: [installer](https://dl.silentmode.st/latest/Pithos-Setup.exe) or [portable exe](https://dl.silentmode.st/latest/Pithos-portable.exe) (SHA-256 sums in [releases-manifest.json](https://dl.silentmode.st/releases-manifest.json) under `pithos-desktop`). The builds are not code-signed yet, so Windows SmartScreen may ask you to confirm with More info › Run anyway. macOS and Linux builds are not published yet; run it from source:
Windows: [installer](https://dl.silentmode.st/latest/Pithos-Setup.exe) or [portable exe](https://dl.silentmode.st/latest/Pithos-portable.exe) (SHA-256 sums in [releases-manifest.json](https://dl.silentmode.st/releases-manifest.json) under `pithos-desktop`). The builds are not code-signed yet, so Windows SmartScreen may ask you to confirm with More info › Run anyway.
Linux (x86-64): [AppImage](https://dl.silentmode.st/latest/Pithos.AppImage), [.deb](https://dl.silentmode.st/latest/Pithos.deb) for Debian and Ubuntu, or [tar.gz](https://dl.silentmode.st/latest/Pithos-linux-x64.tar.gz).
```bash
chmod +x Pithos-*.AppImage && ./Pithos-*.AppImage # needs FUSE 2 (libfuse2 / libfuse2t64 on Ubuntu)
sudo apt install ./Pithos-*-amd64.deb # then start Pithos from the app menu
```
On Linux, s3d's own defaults (`/etc/s3d/s3d.yml`, `/var/lib/s3d`) are for a system service. When those do not exist and you cannot write there, Pithos keeps s3d in your home folder instead: `~/.config/s3d/s3d.yml` and `~/.local/share/s3d`. A hand-run s3d finds that config with `S3D_CONFIG_FILE=~/.config/s3d/s3d.yml`.
macOS builds are not published yet; run it from source:
```bash
npm install

View file

@ -281,8 +281,8 @@
</div>
<div class="card">
<div class="ic">🖥️</div><h3>Desktop app</h3>
<p>A standalone window for Windows: install it, or run the portable exe from anywhere. It fetches s3d on first run, keeps it running while open and stops it when you quit; files s3d has accepted are already safe on disk. It tells you when a new version is out.</p>
<a class="status ok" style="text-decoration:none" href="https://dl.silentmode.st/latest/Pithos-Setup.exe">Windows installer</a> <a class="status ok" style="text-decoration:none" href="https://dl.silentmode.st/latest/Pithos-portable.exe">Portable exe</a> <span class="status soon">macOS &amp; Linux coming</span>
<p>A standalone window for Windows and Linux: install it, or run the portable build from anywhere. It fetches s3d on first run, keeps it running while open and stops it when you quit; files s3d has accepted are already safe on disk. It tells you when a new version is out.</p>
<a class="status ok" style="text-decoration:none" href="https://dl.silentmode.st/latest/Pithos-Setup.exe">Windows installer</a> <a class="status ok" style="text-decoration:none" href="https://dl.silentmode.st/latest/Pithos-portable.exe">Windows portable</a> <a class="status ok" style="text-decoration:none" href="https://dl.silentmode.st/latest/Pithos.AppImage">Linux AppImage</a> <a class="status ok" style="text-decoration:none" href="https://dl.silentmode.st/latest/Pithos.deb">Linux .deb</a> <span class="status soon">macOS coming</span>
</div>
<div class="card">
<div class="ic">🌐</div><h3>Web console</h3>