Documentation
DocumentationLinux server
DOCS / UWA V1 RELEASE CONTRACT SELF-HOSTED GATEWAY

Linux server

Native console or systemd service with staged atomic rollback.

ONE GATEWAYCoordinates → eligible provider → canonical responseWhy UWA
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.

Search local documentation. No external requests.

↑↓ to move · Enter to openESC to close