From 660cbb8463772e2ea018af34a6964152146133c3 Mon Sep 17 00:00:00 2001 From: Local Dev Date: Sun, 4 Oct 2026 23:04:55 +0200 Subject: [PATCH] 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. --- docs/index.html | 7 ++++++- docs/pithos-docs.md | 13 ++++++++++++- index.html | 4 ++-- 3 files changed, 20 insertions(+), 4 deletions(-) diff --git a/docs/index.html b/docs/index.html index bae460c..af99207 100644 --- a/docs/index.html +++ b/docs/index.html @@ -109,7 +109,12 @@ node bin/pithos-web.js
FlagMeaning
--listen host:portAddress to serve on (default 127.0.0.1:8700). Anything beyond loopback needs a password.
--config <s3d.yml>Which s3d config to manage.
--s3d <binary>Use this s3d binary.
--bin-dir <dir>Where Pithos installs s3d.
--password-file <file>Password login (or set PITHOS_PASSWORD, at least 12 characters).
--allow-host <name[:port]>Extra Host names allowed (behind a reverse proxy). Repeatable.

Remote access: PITHOS_PASSWORD='long random secret' node bin/pithos-web.js --listen 0.0.0.0:8700 --allow-host pithos.example.org, behind a TLS reverse proxy.

Desktop app

-

Windows: installer or portable exe (SHA-256 sums in 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 or portable exe (SHA-256 sums in 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, .deb for Debian and Ubuntu, or tar.gz.

+ 
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:

npm install
 npm run desktop

The window signs itself in, installs s3d into its own folder (%APPDATA%\pithos\bin 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 npm run dist:win (or dist:linux / dist:mac on those systems).

diff --git a/docs/pithos-docs.md b/docs/pithos-docs.md index 15d9d5c..039542d 100644 --- a/docs/pithos-docs.md +++ b/docs/pithos-docs.md @@ -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 diff --git a/index.html b/index.html index cf62059..9be2c13 100644 --- a/index.html +++ b/index.html @@ -281,8 +281,8 @@
🖥️

Desktop app

-

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.

- Windows installer Portable exe macOS & Linux coming +

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.

+ Windows installer Windows portable Linux AppImage Linux .deb macOS coming
🌐

Web console