Paired nodes talk to the Cloud API at https://api.allternit.com. Allternit API binds loopback :8013 and is not a public listener. See BYOC Overview and Allternit API.

Configuration File

The runtime uses a YAML configuration file located at /etc/allternit/runtime.yaml:

Environment Variables

You can also use environment variables (they override config file values):

Authentication

API Key

Get your API key from the cloud console (Settings → API Keys):

CORS Origins

Specify which origins can connect to your runtime:

Storage

The runtime uses SQLite by default. For production, consider:
Backup location: /var/lib/allternit/backups/

TLS/SSL

For production, enable TLS:
Or use a reverse proxy (nginx, Caddy, Traefik).

WebSocket Configuration

WebSockets enable real-time communication:

Logging Levels

string
  • debug - Verbose output for troubleshooting
  • info - Normal operational messages
  • warn - Warning conditions
  • error - Error conditions only

Validation

Validate your configuration:

Reload Configuration

Restart the service to apply changes:
Or send SIGHUP for graceful reload (some settings):