The way the application works is pretty straightforward\u2014you set time intervals, and Speedtest Tracker uses the closest Ookla Speedtest<\/a> servers to measure your internet speed in real time. It captures both download and upload speeds, ping, jitter, etc., logs the results, and displays them in a sleek, easy-to-read dashboard.<\/p>\n\n\n\n In this guide, I\u2019ll walk you through the step-by-step process of installing Speedtest Tracker using Docker, making it easy to deploy and manage without complex configurations. So, let’s get started.<\/p>\n\n\n\n Before proceeding with the installation, ensure you have Docker installed on your system. If you don’t have it, the following guides will help you quickly install it.<\/p>\n\n\n\n Just pick the distribution you are using: Ubuntu 24.04<\/a>, Debian 12<\/a>, Arch<\/a>, Alma\/Rocky<\/a>, Fedora<\/a>, Linux Mint 22<\/a>, Pop!_OS 22.04<\/a>, or Raspberry Pi OS<\/a>, and follow the steps to install Docker.<\/p>\n\n\n\n The other essential component is Docker Compose. Recent Docker versions now include Docker Compose by installing the \u201cdocker-compose-plugin<\/em>\u201d package. So, install it if it\u2019s not already in your setup.<\/p>\n\n\n\n As another option, you can also get it separately using both commands below. In that case, remember, when running the tool, to type To be clear, Docker Compose only works if you already have Docker installed and running.<\/p>\n\n\n\n With everything we need already at hand, the first step is to create the project directory in which our Docker Compose deployment file will be placed. Then switch to it; from here on, you need to execute all commands further down in this guide from that location.<\/p>\n\n\n Next, create a \u201cdocker-compose.yml<\/strong><\/em>\u201d file, like a blueprint for our Docker setup. This file will define the services, volumes, ports, etc., telling Docker Compose what to do and how to set up the Speedtest Tracker container.<\/p>\n\n\n As you can see, the Docker deployment is pretty simple. The last three lines in the “environment<\/em>” section are the key to focus on, so let me break them down for you.<\/p>\n\n\n\n For “APP_KEY<\/em><\/strong>,”<\/span> you’ll need to replace “<YOUR-APP-KEY-HERE><\/em>” with a base64-encoded string. Speedtest Tracker uses this key to encrypt and decrypt data, such as user sessions and other sensitive information. To generate one yourself, just run the command below and copy the output as the value for “APP_KEY<\/em>.”<\/span><\/p>\n\n\n Here\u2019s what the final version of the line will look like:<\/p>\n\n\n The next setting\u2014and probably the most important one\u2014is “SPEEDTEST_SCHEDULE<\/em><\/strong>.” This controls how often the app automatically tests your internet connection’s speed. It uses the same scheduling syntax as the CRON daemon.<\/p>\n\n\n\n In our deployment above, I\u2019ve set it to run every hour (“0 * * * *<\/em>“). But of course, you can adjust it to fit your needs, for example, every half hour (“*\/30 * * * *<\/em>“), or say every six hours (“0 *\/6 * * *<\/em>“). It’s all up to your preferences.<\/p>\n\n\n\n If you\u2019re unsure about the exact syntax, don\u2019t worry\u2014we\u2019ve got you covered. Check out our detailed guide, “How to Use Cron on Linux<\/a>,” which will help you get up to speed in no time.<\/p>\n\n\n\n For the last option, “DISPLAY_TIMEZONE<\/em><\/strong>,” set it to your actual one. This ensures that timestamps are shown in your local time. If you have doubts about the correct spelling, check this link<\/a> for a full list of available time zones.<\/p>\n\n\n\n One more useful option to consider\u2014though I don\u2019t use it\u2014is the ability to set a time limit for how long your recorded internet speed statistics are stored before older ones get deleted. So, if you\u2019d like to keep data only for a certain number of days, say the last 30, you can add the following to the “environment<\/em>” section of your Docker Compose deployment:<\/p>\n\n\n For a complete list of all the available options in Speedtest Tracker, check it out here<\/a>.<\/p>\n\n\n\n Finally, just a quick clarification\u2014as you can see, the application runs on the host’s port 8080. Since many containerized applications commonly use this port, you might run into an error if something else is already using it. If that happens, just update the port mapping in your Compose file and switch it to any available one, for example, 8181, and you\u2019re good to go.<\/p>\n\n\n Now, everything is in place, so let’s run our Docker Compose deployment in the background (detached mode):<\/p>\n\n\n So far, so good. Now, let\u2019s move to the most exciting part. Open your browser and navigate to \u201chttp:\/\/localhost:8080<\/em><\/strong>\u201d (if you access Speedtest Tracker from the same host) or \u201chttp:\/\/<server-ip-address>:8080<\/em><\/strong>\u201c (if you access it remotely). Of course, replace the \u201c<server-ip-address><\/em>\u201d part with your actual server\u2019s IP address.<\/p>\n\n\n\n Just to mention, if, for some reason, something goes wrong, you can easily figure out what happened by checking the container log with this simple Docker command:<\/p>\n\n\n When accessing Speedtest Tracker for the first time, enter the app’s default username & password (shown below), then hit the “Sign in<\/em>” button:<\/p>\n\n\n\n I recommend changing the default username and password as your first step. To do this, click on your avatar in the top right corner of Speedtest Tracker, then select “Profile<\/em>” from the menu that appears.<\/p>\n\n\n\n Enter your preferred new ones (your password must be at least eight characters long) and click the “Save changes<\/em>” button to confirm.<\/p>\n\n\n\n And that’s it. Wait for the interval you set to pass, and the first measurement will appear on the dashboard. If you don’t want to wait, you can start a test right away\u2014click the “Speedtest<\/em>” button in the top right, pick a server from the “Select Server<\/em>” dropdown menu, and hit “Start<\/em>.”<\/p>\n\n\n\n From now on, you\u2019ve got a reliable tool to monitor your internet speed and keep tabs on what your ISP is delivering. But of course, Speedtest Tracker isn\u2019t the only option out there.<\/p>\n\n\n\n MySpeed<\/a> is another great alternative, and if you\u2019d rather go with that, our guide<\/a> will walk you through the setup in no time.<\/p>\n\n\n\n For more detailed information about Speedtest Tracker, I strongly recommend checking the official documentation<\/a> or visiting the project\u2019s GitHub page<\/a>.<\/p>\n\n\n\n Lastly, if you consider your service to be accessed via the internet, ensure it\u2019s available via a secure HTTPS connection. You can do this by putting the Speedtest Tracker app behind a reverse proxy like Nginx<\/a>, Nginx Proxy Manager<\/a>, Caddy<\/a>, Traefik, HAProxy, or any other option you prefer.<\/p>\n\n\n\n I hope this guide was helpful. If you have any questions or feedback, feel free to comment below.<\/p>\n","protected":false},"excerpt":{"rendered":" Learn how to install Speedtest Tracker with Docker and monitor your internet speed with real-time results.<\/p>\n","protected":false},"author":10,"featured_media":156887,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[9,4417],"tags":[6027,6030,4980,6293],"class_list":["post-156884","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-tutorials","category-linux-knowledge","tag-myspeed","tag-network-speed","tag-self-hosted","tag-speedtest"],"blocksy_meta":[],"_links":{"self":[{"href":"https:\/\/linuxiac.com\/wp-json\/wp\/v2\/posts\/156884","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/linuxiac.com\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/linuxiac.com\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/linuxiac.com\/wp-json\/wp\/v2\/users\/10"}],"replies":[{"embeddable":true,"href":"https:\/\/linuxiac.com\/wp-json\/wp\/v2\/comments?post=156884"}],"version-history":[{"count":0,"href":"https:\/\/linuxiac.com\/wp-json\/wp\/v2\/posts\/156884\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/linuxiac.com\/wp-json\/wp\/v2\/media\/156887"}],"wp:attachment":[{"href":"https:\/\/linuxiac.com\/wp-json\/wp\/v2\/media?parent=156884"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/linuxiac.com\/wp-json\/wp\/v2\/categories?post=156884"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/linuxiac.com\/wp-json\/wp\/v2\/tags?post=156884"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}![\"Speedtest](\"https:\/\/linuxiac.com\/wp-content\/uploads\/2025\/02\/speedtest-tracker-02-1024x558.jpg\"){kind=tracking}
<\/a>Prerequisites<\/h2>\n\n\n\n
docker-compose<\/code> instead of docker compose<\/code>.<\/p>\n\n\nsudo curl -L \"https:\/\/github.com\/docker\/compose\/releases\/latest\/download\/docker-compose-linux-$(uname -m)<\/span>\"<\/span> -o \/usr\/local<\/span>\/bin\/docker-compose\nsudo chmod +x \/usr\/local<\/span>\/bin\/docker-compose<\/code><\/span>Code language:<\/span> Bash<\/span> (<\/span>bash<\/span>)<\/span><\/small><\/pre>\n\n\nHow to Install Speedtest Tracker with Docker<\/h2>\n\n\n\n
mkdir speedtest\ncd<\/span> speedtest<\/code><\/span>Code language:<\/span> Bash<\/span> (<\/span>bash<\/span>)<\/span><\/small><\/pre>\n\n\nnano docker-compose.yml<\/code><\/span>Code language:<\/span> Bash<\/span> (<\/span>bash<\/span>)<\/span><\/small><\/pre>\n\nservices:<\/span>\n speedtest-tracker:<\/span>\n image:<\/span> lscr.io\/linuxserver\/speedtest-tracker:latest<\/span>\n restart:<\/span> unless-stopped<\/span>\n container_name:<\/span> speedtest<\/span>\n ports:<\/span>\n -<\/span> 8080<\/span>:80<\/span>\n environment:<\/span>\n -<\/span> PUID=1000<\/span>\n -<\/span> PGID=1000<\/span>\n -<\/span> APP_KEY=<YOUR-APP-KEY-HERE><\/span>\n -<\/span> SPEEDTEST_SCHEDULE=\"0<\/span> *<\/span> *<\/span> *<\/span> *\"<\/span>\n -<\/span> DISPLAY_TIMEZONE=America\/New_York<\/span>\n volumes:<\/span>\n -<\/span> .\/speedtest:\/config<\/span><\/code><\/span>Code language:<\/span> YAML<\/span> (<\/span>yaml<\/span>)<\/span><\/small><\/pre>\n\n\necho<\/span> -n 'base64:'<\/span>; openssl rand -base64 32;<\/code><\/span>Code language:<\/span> Bash<\/span> (<\/span>bash<\/span>)<\/span><\/small><\/pre>\n\n\n![\"Generating](\"https:\/\/linuxiac.com\/wp-content\/uploads\/2025\/02\/speedtest-tracker-04.jpg\"){kind=tracking}
<\/a>-<\/span> APP_KEY=base64:iZEBvPkqmwN3j7oiEsEjxk+fzeRI2VSfNJbpXDhG1sk=<\/span><\/code><\/span>Code language:<\/span> YAML<\/span> (<\/span>yaml<\/span>)<\/span><\/small><\/pre>\n\n\n-<\/span> PRUNE_RESULTS_OLDER_THAN=30<\/span><\/code><\/span>Code language:<\/span> YAML<\/span> (<\/span>yaml<\/span>)<\/span><\/small><\/pre>\n\n\nports<\/span>:\n -<\/span> 8181:80<\/span><\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\ndocker compose up -d<\/code><\/span>Code language:<\/span> Bash<\/span> (<\/span>bash<\/span>)<\/span><\/small><\/pre>\n\n\n![\"Deploying](\"https:\/\/linuxiac.com\/wp-content\/uploads\/2025\/02\/speedtest-tracker-05-1024x456.jpg\"){kind=tracking}
<\/a>docker logs speedtest<\/code><\/span>Code language:<\/span> Bash<\/span> (<\/span>bash<\/span>)<\/span><\/small><\/pre>\n\n\n\n
![\"Initial](\"https:\/\/linuxiac.com\/wp-content\/uploads\/2025\/02\/speedtest-tracker-06-1024x662.jpg\"){kind=tracking}
<\/a>![\"Change](\"https:\/\/linuxiac.com\/wp-content\/uploads\/2025\/02\/speedtest-tracker-07-1024x662.jpg\"){kind=tracking}
<\/a>![\"Change](\"https:\/\/linuxiac.com\/wp-content\/uploads\/2025\/02\/speedtest-tracker-08-1024x665.jpg\"){kind=tracking}
<\/a>![\"Manually](\"https:\/\/linuxiac.com\/wp-content\/uploads\/2025\/02\/speedtest-tracker-09-1024x663.jpg\"){kind=tracking}
<\/a>Conclusion<\/h2>\n\n\n\n