`stowage serve`
Run the dashboard HTTP server (and the embedded SigV4 proxy if enabled in config).
#Usage
stowage serve [--config path/to/config.yaml]#Flags
| Flag | Default | Description |
|---|---|---|
--config | "" | Path to a YAML config file. Env vars override values in the file. |
If --config is empty, Stowage uses the built-in defaults.
#Behaviour
- Loads the config file (if any).
- Applies env-var overrides (
STOWAGE_LISTEN, etc.). - Validates the config; exits non-zero on validation failure.
- Initialises the SQLite store, applying any pending migrations.
- Initialises the backend registry from the config + DB-managed endpoints, runs an initial probe per backend.
- Starts the dashboard HTTP server on
server.listen. - If
s3_proxy.enabled: true, starts the proxy listener ons3_proxy.listen. - Runs until SIGTERM / SIGINT, then drains in-flight requests up to
server.shutdown_timeout(default 10s) before exiting.
#Environment-variable overrides
See Configuration → environment variables.
#Exit codes
| Code | Meaning |
|---|---|
| 0 | Clean shutdown after SIGTERM/SIGINT. |
| 1 | Config load or validation failure, or unrecoverable startup error. |