# Speedtest Monitor

Speedtest Monitor is a self-hosted network services app. Self-hosted internet speed monitor that runs Cloudflare Speed Test on a configurable schedule and tracks connection performance over time. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/3332/speedtest-monitor

## Description

Self-hosted internet speed monitor that runs Cloudflare Speed Test on a configurable schedule and tracks connection performance over time. It stores every measurement in SQLite and serves a live dashboard over WebSocket, with alerts (webhook, ntfy, Discord, Slack, SMTP), authentication with local accounts and OpenID Connect (OIDC), and role-based access (admin / viewer).

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

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

## Links

- Unraid: https://ca.unraid.net/apps/speedtest-monitor-0ior3iq15iohwm?q=speedtest-monitor
- GitHub: https://github.com/Greite/speedtest-monitor

## Common questions

### Where is the data stored so I can back it up?

Speedtest-monitor stores measurements and settings in a SQLite database at /data/speedtest.db by default. You should persist that /data directory, and also /data/logs if you want to keep rotated log files.

### What do I need to set when serving it behind a reverse proxy?

On first boot, set AUTH_SECRET and BETTER_AUTH_URL. BETTER_AUTH_URL is required when the app is accessed behind a reverse proxy.

### Which port do I need to expose?

The dashboard and WebSocket are served from the same HTTP port. The default is PORT 3000.

### How do I create the first admin account?

You can set SPEEDTEST_ADMIN_EMAIL and SPEEDTEST_ADMIN_PASSWORD on first boot. Alternatively, open the /setup page in the browser to create the first admin.

### How should I tune the tests for a very high-bandwidth connection?

Raise SPEEDTEST_TEST_DURATION_S so each phase has more time, and increase SPEEDTEST_PARALLEL_STREAMS to help saturate high-bandwidth links. The docs suggest trying 16 parallel streams on a 10 Gbps link.

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