# Environment Variables ### Application

Name	Required	Description	Example
`PUID`	true	Used to set the user the container should run as.	`1000`
`PGID`	true	Used to set the group the container should run as.	`1000`
`APP_KEY`	true	Key used to encrypt and decrypt data. See the install docs to generate a key.
`APP_URL`	true	URL used for links in emails and notifications.	`https://speedtest.example.com`
`APP_NAME`	false	Used to define the application's name in the dashboard and in notifications.
`ADMIN_NAME`	false	Name of the initial admin user. Note: Only effective during initial setup.	`Admin`
`ADMIN_EMAIL`	false	Email of the initial admin user. Note: Only effective during initial setup.	`admin@example.com`
`ADMIN_PASSWORD`	false	Password of the initial admin user. Note: Only effective during initial setup.	`password`
`ASSET_URL`	false	URL used for assets, needed when using a reverse proxy.	`https://speedtest.example.com`
`APP_LOCALE`	false	Change the default language.
`APP_TIMEZONE`	false	Application timezone should be set if your database does not use UTC as its default timezone.	`Europe/London`
`ALLOWED_IPS`	false	Block requests to the application unless from the allowed addresses.	`127.0.0.1,127.0.0.2`

*** ### Display

Name	Required	Description	Example
`CHART_BEGIN_AT_ZERO`	false	Begin the dashboard axis charts at zero. - Default: `true`	`true` or `false`
`CHART_DATETIME_FORMAT`	false	Set the formatting of timestamps in charts. Formatting: https://www.php.net/manual/en/datetime.format.php	`j/m G:i` (18/10 20:06)
`DATETIME_FORMAT`	false	Set the formatting of timestamps in tables and notifications. Formatting: https://www.php.net/manual/en/datetime.format.php	`j M Y, G:i:s` (18 Oct 2024, 20:06:01)
`DISPLAY_TIMEZONE`	false	Display timestamps in your local time.	`America/New_York`
`CONTENT_WIDTH`	false	Width of the content section of each page. Can be set to any value found in the Filament docs. - Default: `7xl`
`PUBLIC_DASHBOARD`	false	Enables the public dashboard for guest (unauthenticated) users. - Default: `false`
`DEFAULT_CHART_RANGE`	false	Set the default time range for the dashboards - Default: `24h`	Options: `24h`, `week` or `month`

*** ### Speed tests

Name	Required	Description	Example
`SPEEDTEST_SKIP_IPS`	false	A comma separated list of public IP addresses where tests will be skipped when present.	`127.0.0.1` or `127.0.0.0/16`
`SPEEDTEST_SCHEDULE`	false	Cron expression used to run speedtests on a scheduled basis. https://crontab.guru/ is a helpful tool.	`6 /2 * ` (At minute 6 past every 2nd hour)*
`SPEEDTEST_SERVERS`	false	Comma separated list of server IDs to randomly use for speedtest. To find servers near you visit: https://www.speedtest.net/api/js/servers	`52365` or `36998,52365`
`SPEEDTEST_BLOCKED_SERVERS`	false	Comma separated list of server IDs that should not be used when running an Ookla Speedtest.
`SPEEDTEST_INTERFACE`	false	Set the network interface to use for the test. This need to be the network interface available inside the container	`eth0`
`SPEEDTEST_EXTERNAL_IP_URL`	false	URL of a service used to get the external WAN IP address. URL should contain the protocol i.e. `https://`	`https://icanhazip.com`
`SPEEDTEST_INTERNET_CHECK_HOSTNAME`	false	Hostname used to ping for an active internet connection.
`THRESHOLD_ENABLED`	false	Enable the thresholds. Note: Only effective during initial setup.	`true`
`THRESHOLD_DOWNLOAD`	false	Set the Download Threshold Note: Only effective during initial setup.	`900`
`THRESHOLD_UPLOAD`	false	Set the Upload Threshold Note: Only effective during initial setup.	`900`
`THRESHOLD_PING`	false	Set the Ping Threshold Note: Only effective during initial setup.	`25`
`PRUNE_RESULTS_OLDER_THAN`	false	Set the value to greater than zero to prune stored results. This value should be represented in days, e.g. `7` will purge all results over 7 days old.	`7`

*** ### API

Name	Required	Description	Example
`API_RATE_LIMIT`	false	Number of requests per minute to the API. - Default: `60`	`100`
`API_MAX_RESULTS`	false	Sets the maximum number of results returned by API. - Default `500`	`500`

--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.speedtest-tracker.dev/getting-started/environment-variables.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.