Using Docker or Docker Compose

These steps will run you through setting up the application using Docker and Docker Compose.

Setting up your environment with Docker Compose is the recommended infrastructure pattern as it'll setup the application and a database for you. SQLite is fine for most installs but we also provide instructions for setting up MariaDB, MySQL and Postgres should you prefer those database drivers.

If you would like to provide your own SSL keys, they must be named cert.crt (full chain) and cert.key (private key), and mounted in the container folder /config/keys.

version: '3.4'
        container_name: speedtest-tracker
            - 8080:80
            - 8443:443
            - PUID=1000
            - PGID=1000
            - DB_CONNECTION=sqlite
            - /path/to/data:/config
            - /path/to-custom-ssl-keys:/config/keys
        restart: unless-stopped

Install with Docker

These instructions assume you have an appropriate database instance that already exists.

docker run -d --name speedtest-tracker --restart unless-stopped \
    -p 8080:80 \
    -p 8443:443 \
    -e PUID=1000 \
    -e PGID=1000 \
    -e DB_CONNECTION=sqlite \
    -v /path/to/data:/config \
    -v /path/to-custom-ssl-keys:/config/keys \

Last updated