silentmode/theseus
4
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs(theseus): add-on update channel lives on Sia, not the VPS — publish with sia-upload

Browse source 
The publishing steps pointed at scp to /opt/silent-mode/site/addons/, which
never existed; the screenshot channel (and now aegis) is served from
s3://bns/theseus/extensions/<id>/ through navigate.st/bns/theseus.x/….
Also: sign from a git-archive copy so uncommitted edits don't ship.
This commit is contained in:
Local Dev 2026-09-10 22:25:18 +02:00
parent 2cd0973a1c
commit bdae8f5fc5
1 changed files with 16 additions and 9 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

25
docs/ADDON-UPDATES.md
View file

@ -37,27 +37,34 @@ no outbound requests.
### Every update ### Every update
Sign from a clean copy of the committed add-on (`git archive HEAD …`), not
the working tree, so another session's uncommitted edits don't ship:
``` ```
node scripts/sign-addon-update.mjs \ node scripts/sign-addon-update.mjs \
bundled-addons/screenshot \ <clean-copy>/bundled-addons/screenshot \
https://addons.silentmode.st/screenshot \ https://navigate.st/bns/theseus.x/extensions/screenshot \
"$USERPROFILE/.silentmode/ops/addon-update-key.pem" "$USERPROFILE/.silentmode/ops/addon-update-key.pem" --out out/
``` ```
Produces: Produces:
- `out/screenshot-<version>.tar.gz` — upload to `<base-url>/<id>-<version>.tar.gz` - `out/screenshot-<version>.tar.gz` — upload to `<base-url>/<id>-<version>.tar.gz`
- `out/screenshot-<version>.entry.json` — prepend to your live `updates.json` - `out/screenshot-<version>.entry.json` — prepend to your live `updates.json`
Then: The channel files live on Sia, under `s3://bns/theseus/extensions/<id>/`,
and are served through the public gateway as
`https://navigate.st/bns/theseus.x/extensions/<id>/…` — that is what every
bundled add-on's `updateURL` points at. Nothing is on the VPS filesystem.
Upload with the Sia uploader (single file → directory prefix, not a full
target path):
``` ```
scp out/screenshot-*.tar.gz silentmode:/opt/silent-mode/site/addons/screenshot/ node ../Argus/src/lib/sia-upload.js out/screenshot-<version>.tar.gz bns/theseus/extensions/screenshot
scp updates.json silentmode:/opt/silent-mode/site/addons/screenshot/ node ../Argus/src/lib/sia-upload.js updates.json bns/theseus/extensions/screenshot
``` ```
The Sia autosync timer picks up `/opt/silent-mode/site/` on its usual Then confirm both URLs answer 200 through the gateway before relying on
5-minute cadence, so both mirrors update together (see the entry. Live channels: `screenshot` and `aegis`.
`shipping-mirrors` for background).
## `updates.json` schema ## `updates.json` schema