# Ookla Speedtest MQTT

Ookla Speedtest MQTT is a self-hosted network services app. A lightweight container that periodically runs Ookla's Speedtest CLI and publishes the JSON-formatted results to a Message Queuing Telemetry Transport (MQTT) broker. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/2339/ookla-speedtest-mqtt

## Description

A lightweight container that periodically runs Ookla's Speedtest CLI and publishes the JSON-formatted results to a Message Queuing Telemetry Transport (MQTT) broker. It is for homelabbers who want automated, cron-scheduled internet speed measurements feeding MQTT-based dashboards and automations.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

33/100 (Low), based on 4 of 4 factors.
- Maintained: 61 (last commit 142 days ago)
- Popular: 0 (0 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 10 (16 GB minimum RAM)

## Links

- Docker Hub: https://hub.docker.com/r/ccmpbll/ookla-speedtest-mqtt/
- Unraid: https://ca.unraid.net/apps/ookla-speedtest-mqtt-0n48jjn0x7emfj?q=ookla-speedtest-mqtt

## Common questions

### What environment variables must be set before running ookla-speedtest-mqtt?

You must provide MQTT_SERVER, MQTT_TOPIC, CRON, and TZ. Optional settings include SERVER_ID, MQTT_USER, and MQTT_PASS.

### How can I point the speed test at a specific Ookla server?

Set the optional SERVER_ID environment variable to the numeric ID of the server you want to use.

### How can I secure the MQTT broker connection?

Set the optional MQTT_USER and MQTT_PASS environment variables to send a username and password.

### How can I store the published results in InfluxDB?

Use Telegraf with an mqtt_consumer input and json_v2 data format. The README gives field mappings for ping, download, upload, packet loss, ISP, and external IP.

---
Source: Our Local Host (https://ourlocalhost.com/app/2339/ookla-speedtest-mqtt), the self-hosted and open-source app directory.
