Dashboard Configuration

Configure the HTTP API and web dashboard.

Basic setup

[dashboard]
port = 3210
token = "${AKSHI_TOKEN}"

Full options

[dashboard]
port = 3210
bind_address = "127.0.0.1"
token = "${AKSHI_TOKEN}"
auth = true
cors_origins = ["http://127.0.0.1:3210"]
rate_limit = 300
rate_limit_burst = 50
sse_keepalive_secs = 15

Field reference

Field	Type	Default	Description
`port`	integer	`3210`	HTTP listen port
`bind_address`	string	`127.0.0.1`	Bind address
`token`	string	auto-generated	API authentication token
`auth`	boolean	`true`	Enable authentication
`cors_origins`	string[]	`["http://127.0.0.1:3210"]`	Allowed CORS origins
`rate_limit`	integer	`300`	Requests per minute
`rate_limit_burst`	integer	`50`	Burst request limit
`sse_keepalive_secs`	integer	`15`	SSE keepalive ping interval

Disabling authentication

For local development only:

[dashboard]
auth = false

Never disable auth on a network-accessible interface.

CORS for external dashboards

If you host the dashboard UI separately:

[dashboard]
cors_origins = ["https://dashboard.example.com", "http://localhost:5173"]

Rate limiting

Rate limits apply per source IP. When exceeded, the API returns 429 Too Many Requests with a Retry-After header. Adjust limits based on your client count and monitoring frequency.

Keyboard shortcuts