HTTP + WebSocket port served by the app.

Target

3000

Default

3000

Value

3000

Persistent storage for the SQLite database (speedtest.db).

Target

/data

Default

/mnt/user/appdata/speedtest-monitor

Value

/mnt/user/appdata/speedtest-monitor

REQUIRED. Secret used to sign session cookies. Generate with: openssl rand -base64 32

Public URL of the dashboard, used by Better Auth for sign-in callbacks and OIDC redirects (e.g. https://speedtest.example.com). REQUIRED when running behind a reverse proxy. Defaults to http://localhost:PORT if unset - fine for direct local access only.

Default measurement interval in minutes (1-1440). Can be changed at runtime from /settings without restarting.

Default

15

Value

15

First-run admin email (optional). When set together with SPEEDTEST_ADMIN_PASSWORD, the admin is auto-seeded on every boot (idempotent). Leave empty to use the /setup wizard instead.

First-run admin password (optional, min 10 chars). Used together with SPEEDTEST_ADMIN_EMAIL. Updating this value rehashes the admin password on the next boot.

Public URL of the dashboard (e.g. https://speedtest.example.com). Used to build deep links in alert emails. Leave empty if unused.

Duration of each download/upload phase in seconds. Raise to 20-30 for multi-Gbps links so TCP slow-start does not dominate the sample.

Default

10

Value

10

Parallel HTTP streams per phase. Increase (e.g. 16) on very high-bandwidth links to saturate the pipe.

Default

8

Value

8

Absolute path to the SQLite database file. Must live under the App Data volume.

Default

/data/speedtest.db

Value

/data/speedtest.db

Internal HTTP port. Only change if you know what you are doing - must match the WebUI port mapping above.

Default

3000

Value

3000

Generic webhook URL for alerts (optional). Leave empty if unused.

Optional JSON object of extra headers for the generic webhook (e.g. {"Authorization":"Bearer xxx"}).

Full ntfy URL including the topic, e.g. https://ntfy.sh/my-topic. Leave empty if unused.

Optional ntfy access token (for protected topics).

Discord webhook URL for alerts (optional).

Slack incoming webhook URL for alerts (optional).

SMTP server hostname for email alerts (optional). Required together with SPEEDTEST_SMTP_FROM and SPEEDTEST_SMTP_TO to enable email.

SMTP port. Defaults to 587 (STARTTLS).

Default

587

Value

587

'true' for implicit TLS (port 465), 'false' for STARTTLS, leave empty for auto-detect from port.

SMTP username (optional, for authenticated SMTP).

SMTP password (optional, for authenticated SMTP).

Sender address for alert emails, e.g. speedtest@example.com.

Recipient address for alert emails (single address or comma-separated list).

OIDC issuer URL (optional), e.g. https://auth.example.com. Required together with the client id/secret to enable SSO.

OIDC client id (optional).

OIDC client secret (optional).

Label shown on the OIDC sign-in button.

Default

SSO

Value

SSO

Email of the user to auto-promote to admin on first OIDC sign-in.

'true' to auto-create accounts on first OIDC sign-in, 'false' to require admin pre-provisioning.

Default

true

Value

true