# Speedtest Tracker

> Internet speed monitoring dashboard.

- Category: Monitoring & Observability
- Difficulty: beginner
- Components: speedtest-tracker, sqlite
- Tags: speedtest, bandwidth, monitoring, network
- Source: https://docker.recipes/monitoring/speedtest-tracker

## Overview

Speedtest Tracker is a self-hosted web application that automatically monitors your internet connection speed by running periodic speed tests against multiple testing servers. Built with PHP and Laravel, it provides a comprehensive dashboard for tracking bandwidth performance over time, identifying connectivity issues, and generating detailed reports of your network's performance history. The application integrates with popular speed testing services like Ookla Speedtest and LibreSpeed to ensure accurate measurements across different testing methodologies.

This stack combines Speedtest Tracker with SQLite as the embedded database solution, creating a lightweight monitoring system that requires minimal resource overhead while maintaining full functionality. SQLite eliminates the need for a separate database server, making the deployment incredibly simple while still providing robust data storage for historical speed test results, configuration settings, and performance analytics. The combination ensures fast data retrieval for dashboard visualizations and efficient storage of time-series network performance data.

Home lab enthusiasts, small business owners, and network administrators will find this stack invaluable for documenting ISP performance, troubleshooting connectivity issues, and maintaining SLA compliance records. The SQLite backend makes it perfect for single-user deployments or small teams who need reliable network monitoring without the complexity of managing separate database infrastructure, while still providing enterprise-grade monitoring capabilities.

## Features

- Automated speed tests scheduled at configurable intervals using cron-style scheduling
- Multi-server testing support with automatic server selection based on geographic proximity
- Historical performance graphs showing download, upload, and latency trends over customizable time periods
- SQLite database integration providing zero-configuration data persistence with automatic schema management
- Threshold-based alerting system for detecting performance degradation below specified bandwidth limits
- Export functionality for speed test data in CSV and JSON formats for external analysis
- Mobile-responsive dashboard optimized for monitoring network performance on smartphones and tablets
- API endpoints for integrating speed test data with external monitoring systems and automation tools

## Use cases

- Home office workers documenting internet performance for remote work productivity analysis
- Small businesses monitoring ISP service level agreement compliance and performance guarantees
- Content creators tracking upload bandwidth consistency for streaming and video production workflows
- IT support teams troubleshooting intermittent connectivity issues with historical performance data
- Home lab administrators monitoring network infrastructure changes and optimization efforts
- Property managers providing internet performance transparency to tenants in shared connectivity environments
- Network enthusiasts comparing ISP performance across different time periods and usage patterns

## Prerequisites

- Docker Engine 20.10+ and Docker Compose V2 for container orchestration support
- Minimum 512MB RAM allocated for Speedtest Tracker container and SQLite operations
- Available TCP port 8080 for web dashboard access without conflicts from other services
- Stable internet connection capable of handling automated speed tests without data cap concerns
- Basic understanding of cron scheduling syntax for configuring automated test intervals
- Web browser with JavaScript enabled for accessing the responsive monitoring dashboard

## docker-compose.yml

```yaml
services:
  speedtest:
    image: lscr.io/linuxserver/speedtest-tracker:latest
    container_name: speedtest-tracker
    restart: unless-stopped
    environment:
      PUID: 1000
      PGID: 1000
      TZ: UTC
      DB_CONNECTION: sqlite
    volumes:
      - speedtest_config:/config
    ports:
      - "8080:80"

volumes:
  speedtest_config:
```

## .env

```bash
# Runs speedtest every hour
```

## Usage notes

- Access at http://localhost:8080
- Scheduled speed tests
- Historical graphs

## Troubleshooting

- Speed tests failing with 'No servers available': Configure firewall to allow outbound connections on ports 8080 and 5060, and verify DNS resolution is working properly
- Dashboard shows 'Database connection failed': Check that the speedtest_config volume has proper write permissions and sufficient disk space for SQLite database growth
- Scheduled tests not running automatically: Verify the TZ environment variable matches your local timezone and check container logs for cron service status
- High memory usage during speed tests: Reduce concurrent test frequency in settings and ensure container has adequate memory allocation for peak testing periods
- Historical data missing after container restart: Confirm the speedtest_config volume is properly mounted and persistent across container lifecycle events
- Web interface loading slowly: Clear browser cache and check that SQLite database file hasn't grown excessively large, consider archiving old test results

