Environment variables
The full list of variables that configure a OneSVD node.
Every deployment-specific value is an environment variable, so one build runs anywhere. Set them before installing or in the service environment.
Paths & ports#
The hub reads these at runtime. onesvd writes them into the service units from your config, so the way to change them is onesvd dir and onesvd config set — not by exporting these directly.
| Variable | Config key | Default | Description |
|---|---|---|---|
ONESVD_ROOT | watch_dir | (chosen at install) | Watched directory (absolute, auto-created). |
ONESVD_HUB_PORT | hub_port | 4000 | Hub WebSocket + HTTP port. |
ONESVD_INGEST_PORT | ingest_port | 4001 | Loopback ingest port. |
| — | frontend_port | 7777 | Web client port (passed to Next.js). |
Access#
| Variable | Default | Description |
|---|---|---|
ONESVD_TOKEN | (empty) | Bearer token for write endpoints and the UI. |
ONESVD_ALLOW_IPS | (empty) | Comma-separated IP allowlist (loopback always allowed). |
Note:
The token, allowlist, and TLS values aren't managed by onesvd config. The hub reads them from its environment — set them in ~/.local/share/onesvd/server/.env (auto-loaded on start) or in the systemd unit.
TLS#
| Variable | Description |
|---|---|
ONESVD_TLS_KEY | Private key path; enables HTTPS/WSS with the cert. |
ONESVD_TLS_CERT | Full-chain certificate path. |
ONESVD_PUBLIC_HOST | Public hostname for absolute links. |
Installer#
These tune the curl … | bash bootstrap.
| Variable | Default | Description |
|---|---|---|
ONESVD_HOME | ~/.local/share/onesvd | Where the source is cloned and built. |
ONESVD_REPO | (repo URL) | Git URL to clone. |
ONESVD_BRANCH | main | Branch to check out. |
ONESVD_NO_LINGER | (unset) | Set to 1 to skip enabling systemd linger — no boot-start and no sudo prompt. |
The old ONESVD_FRONTEND_MODE is now a config key: switch the dev server on with onesvd config set frontend_mode dev.