DOCS / UWA V1 RELEASE CONTRACT SELF-HOSTED GATEWAY
Linux server
Native console or systemd service with staged atomic rollback.
On this page 3 sections
#Native build
Build with Go 1.27.3+ and review the Linux systemd unit and installer scripts before running privileged commands.
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 \
go build -o gateway-linux-amd64 ./cmd/gateway
sudo deployments/linux/install.sh ./gateway-linux-amd64#Configure and start
Review /etc/universal-weather-api/gateway.env, set a valid PostgreSQL DSN, Redis address, provider quota budgets, credentials and provider policy, then run:
sudo systemctl start universal-weather-api
systemctl status universal-weather-api
journalctl -u universal-weather-api -f
curl -f http://127.0.0.1:8080/readiness#Staged updates and operational boundaries
The unit runs under an unprivileged account with systemd notify and watchdog support. deployments/linux/update.sh stages candidate binaries before stopping the service and uses a failure trap to restore the prior binary and running state if post-stop steps fail. Place an external TLS reverse proxy in front of the gateway for public ingress.
Canonical contracts:
docs/openapi.yaml (lean_v1) and docs/openapi.experimental.yaml · Verify against your build before production use.