svesnav/runix
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 7 Wiki Activity

README: install and update from object storage

Browse Source
This commit is contained in:
svesnav
2026-07-27 13:04:23 +03:00
parent 3faa4927cf
commit 0ae771786a
2 changed files with 70 additions and 32 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+11 -14
View File
@@ -17,15 +17,11 @@ One command sets up a host. Run it as root; it asks what the host should be
`/opt/runix`, and wires up systemd.
```sh
curl -fsSL https://vcs.astra-dev.online/svesnav/runix/raw/branch/main/install.sh | sudo sh
curl -fsSL https://runix-releases.s3-alpha-web.astra-dev.online/install.sh | sudo sh
```
Prefer to pin a version, or your instance still requires sign-in to read raw
files? Use the release asset instead — it downloads without a login:
```sh
curl -fsSL https://vcs.astra-dev.online/svesnav/runix/releases/download/v0.5.0/install.sh | sudo sh -s -- --role all-in-one
```
Binaries are served from object storage, so this needs no account and no
token. To pin a version, add `--version v0.5.0`.
### Roles
@@ -56,16 +52,15 @@ services restarted, while your configuration (above all the JWT and
encryption secrets) is preserved:
```sh
curl -fsSL https://vcs.astra-dev.online/svesnav/runix/raw/branch/main/install.sh | sudo sh -- -y
curl -fsSL https://runix-releases.s3-alpha-web.astra-dev.online/install.sh | sudo sh -s -- -y
```
Or update from the UI: an administrator sees an **Updates** page that checks
this repository for the latest release and updates the control plane and each
object storage for the latest release and updates the control plane and each
agent with one click. Point a control plane at this repository with:
```
RUNIX_UPDATE_API_BASE=https://vcs.astra-dev.online/api/v1
RUNIX_UPDATE_REPO=svesnav/runix
RUNIX_UPDATE_MANIFEST=https://runix-releases.s3-alpha-web.astra-dev.online/latest.json
```
## Releases
@@ -78,11 +73,13 @@ Each release publishes, for `linux/amd64` and `linux/arm64`:
- `SHA256SUMS` — checksums; the installer verifies every download against it
Binaries are built automatically from source on tag by the CI runner and
published here and to the source repository.
published to object storage as well as to this repository. `latest.json`
beside them names the newest version and every asset's checksum — that is
what the installer and the in-app updater read.
## Verify a download by hand
```sh
curl -fsSLO https://vcs.astra-dev.online/svesnav/runix/releases/download/v0.5.0/runix-server_linux_amd64
curl -fsSL https://vcs.astra-dev.online/svesnav/runix/releases/download/v0.5.0/SHA256SUMS | sha256sum -c --ignore-missing
curl -fsSLO https://runix-releases.s3-alpha-web.astra-dev.online/v0.5.0/runix-server_linux_amd64
curl -fsSL https://runix-releases.s3-alpha-web.astra-dev.online/v0.5.0/SHA256SUMS | sha256sum -c --ignore-missing
```