Speeder

Python script to monitor your internet speed! 🚀

Periodically run librespeed/speedtest-cli and send results to InfluxDB.

Quick Start

Note The assumption is made that you've already setup InfluxDB 2.x.x. Alternatively, you can use the Docker Compose method where this is setup for you.

List available server IDs:

docker run --rm -it ghcr.io/dbrennand/speeder:latest /librespeed --list

Next, start and configure speeder using the environment variables:

docker run -itd --rm --name speeder \
    -e "SPEEDER_SPEEDTEST_INTERVAL=300" \
    -e "SPEEDER_SPEEDTEST_SERVER_ID=49" \
    -e "SPEEDER_INFLUXDB_HOST=influx.example.com" \
    -e "SPEEDER_INFLUXDB_TOKEN=<Token>" \
    -e "SPEEDER_INFLUXDB_ORG=speeder" \
    -e "SPEEDER_INFLUXDB_BUCKET=speeder" \
    ghcr.io/dbrennand/speeder:latest

Environment Variables

The speeder script is configured using the below environment variables:

| Name | Description | Default Value | | ----------------------------- | ------------------------------------------------------------------------------------------ | ------------- | | SPEEDER_SPEEDTEST_INTERVAL | Interval in seconds to run speedtests on. | 300 | | SPEEDER_SPEEDTEST_SERVER_ID | Server ID to run speedtests against. Supports multiple IDs using a comma separated string. | "" | | SPEEDER_INFLUXDB_HOST | InfluxDB hostname. | influxdb | | SPEEDER_INFLUXDB_PORT | InfluxDB port. | 8086 | | SPEEDER_INFLUXDB_TOKEN | InfluxDB token. | speeder! | | SPEEDER_INFLUXDB_ORG | InfluxDB organisation name. | speeder | | SPEEDER_INFLUXDB_BUCKET | InfluxDB bucket name to write speedtest results to. | speeder |

Docker Compose Stack - InfluxDB and Grafana

The docker-compose.yml file in this repository will deploy speeder, InfluxDB 2.8 and Grafana 12.3.1 containers. Grafana will be provisioned with InfluxDB as the data source and the pre-created dashboard:

1. Set the SPEEDER_SPEEDTEST_SERVER_ID environment variable located in the .env file to the server IDs to perform speedtests against.

   Note

   If you don't know any server IDs, run the following command to list them:

   docker run --rm -it ghcr.io/dbrennand/speeder:latest /librespeed --list
   

2. Set the DOCKER_INFLUXDB_INIT_PASSWORD, DOCKER_INFLUXDB_INIT_ADMIN_TOKEN and GF_SECURITY_ADMIN_PASSWORD environment variables located in the .env file.

3. Start the compose stack:

   docker compose up -d
   

Grafana will be accessible at http://localhost:3000 and your host's IP address.

Disclaimer

I did NOT create the LibreSpeed project or CLI. The great folks over at LibreSpeed did.

If you like this project then please give their repositories a star! ⭐

Authors -- Contributors

Daniel Brennand - Author

License

This project is licensed under the MIT License - see the LICENSE for details.