Repository navigation
v1.1.0
What's New
Background Daemon Management
Run Relay as a background service that survives terminal closure. Uses pm2 under the hood (auto-installed on first use).
relay start # Start as background daemon
relay stop # Stop the daemon
relay restart # Restart the daemon
relay logs # Tail daemon logs (Ctrl+C to exit)
relay status # Show PID, uptime, memory, restartsSelf-Update
relay updateAuto-detects install method (npm global or git source) and updates accordingly. Restarts the daemon automatically if running.
Config System
- New
src/config/module with schema, loader, and interactive setup wizard - Config resolution: CLI flags > config file > env vars > defaults
relay onboardinteractive wizard for first-time setup- Config stored in
.relay/config.json
Structured Logging
- Pino-based JSON logging with child loggers per component
- Configurable log levels via
--log-level
Improved Error Messages
- Startup errors now show clean, readable messages instead of raw JSON logs with stack traces
- Missing SDK packages show clear install instructions
- Missing config prompts users to run
relay onboard
Other Changes
- Removed
.env.examplein favor of config file approach - Updated all documentation (main + website)
Upgrading from v1.0.x
# npm
npm install -g @4via6/relay@latest
# From source
git pull && npm install && npm run buildAfter upgrading, relay update handles all future updates.