xvii-node
| Where |
Job |
| Control plane |
reads /etc/xvii/platform.json (written by home) and converges: per service a system user, folders, a PostgreSQL database and role, an OIDC client at id, an env file, a systemd unit and a Caddy site; swaps releases, waits for health, rolls back |
| Every node |
dials wss://apps.xvii.network/agent, converges Docker workloads (team networks, volumes, limits, health checks), serves or relays their traffic, streams status, metrics and logs, builds images, keeps going from its last desired state when apps is unreachable |
| Name servers |
xvii-node dns URL TOKEN pulls domains' zones and answers on port 53 |
| Mail edge |
xvii-node edge IP relays mail ports and sends outgoing mail from its address |
The manifest
Each release carries manifest.json describing how to install the service: its port, host label,
wildcard and extra host names, whether it needs a database and an OIDC client, groups, paths it may write,
fixed settings, settings superusers may change in home, admin commands, and whether it binds low ports.
Commands
See CLI reference → xvii-node.
Updates · Nodes ·
Configuration