Frequently Asked Questions

A running list of frequently ask questions and their answers.

Docker

I get a warning on container start up that the APP_KEY is missing

You can generate a key here: https://speedtest-tracker.dev.

Notifications

Time zones

How do I set the display and schedule time zone?
  1. Set DISPLAY_TIMEZONE environment variables to your local timezone.

  2. Restart the container

My display timestamps or scheduled tests aren't correct.

Speedtest Tracker assumes your application and database containers are set to UTC by default. If your database instance has your local time zone set it needs to match that set in APP_TIMEZONE and DISPLAY_TIMEZONE environment variables.

Once set restart the container.

Other

AdGuard & Pi-hole allow domains

When a speedtest is being processed Speedtest Tracker will make a call to http://icanhazip.com to get your external IP address. This is done to determine if your server has access to the internet and to check if your external IP address (WAN IP) should be skipped.

Some blocks lists will block this domain, if you're getting errors and your server has access to the internet you'll need to add this to your allow lists.

Cron schedule "from" a minute or hour

Starting your cron schedule from a minute our hour can help avoid congestion on the network or a speedtest server. This comment on the issue can help you get the formatting right.

I'm getting a 500 | SERVER ERROR error

By default APP_DEBUG is set to false in production to prevent verbose error outputs. To debug the issue follow the steps below.

  1. Set APP_DEBUG=true as a environment variable

  2. Restart the container

  3. Reproduce the error by visiting the page or performing the action that caused the error

  4. View the output in the UI or in the logs to help resolve the issue, if you can not resolve it open an issue in the GitHub repository

  5. In the output the line that starts with [timestamp] production.ERROR: is the error the server ran into

  6. Once the issue is resolved you can remove the APP_DEBUG environment variable

Last updated