LibreSpeed Speed Test

beginner

LibreSpeed self-hosted speed test for measuring local network performance.

Overview

LibreSpeed is an open-source, HTML5-based internet speed testing tool that allows organizations to deploy their own speed testing infrastructure without relying on external services like Speedtest.net or Fast.com. Originally developed as a lightweight alternative to Flash-based speed tests, LibreSpeed uses modern web technologies to measure download speed, upload speed, ping, and jitter through a clean, responsive interface that works across all devices and browsers. The LinuxServer.io Docker image provides a containerized deployment of LibreSpeed with proper user management, timezone support, and optional administrative features for managing test configurations and viewing historical results. This self-hosted approach gives network administrators complete control over their speed testing data, eliminates external dependencies that could skew results, and provides a consistent testing endpoint for measuring internal network performance. LibreSpeed is particularly valuable for IT departments, MSPs, and network engineers who need to validate network performance claims, troubleshoot connectivity issues, or provide users with a trusted speed testing tool that reflects actual network conditions rather than internet-wide performance.

Key Features

HTML5-based speed testing with no Flash or Java dependencies
Measures download speed, upload speed, ping latency, and connection jitter
Responsive web interface that works on desktop, mobile, and tablet devices
Optional password-protected admin panel for configuration management
Telemetry system for storing and analyzing historical test results
Customizable test parameters including duration, chunk size, and server selection
Multi-language support with internationalization capabilities
IP address geolocation and ISP detection for result context

Common Use Cases

1MSPs validating customer internet connection speeds against SLA commitments
2Corporate IT departments troubleshooting employee connectivity complaints
3Home lab enthusiasts testing internal network performance and WiFi coverage
4ISPs providing customers with unbiased speed testing tools
5Data centers offering tenants internal network performance validation
6Educational institutions monitoring campus network performance
7Remote work support teams diagnosing employee connection issues

Prerequisites

Docker and Docker Compose installed on the host system
Minimum 512MB RAM available for the LibreSpeed container
Port 8080 available and accessible from client devices
Sufficient network bandwidth to handle concurrent speed tests
Basic understanding of network performance metrics and testing methodology
Web browser with HTML5 support on client devices performing tests

For development & testing. Review security settings, change default credentials, and test thoroughly before production use. See Terms

docker-compose.yml

1services: 
2  librespeed: 
3    image: linuxserver/librespeed:latest
4    container_name: librespeed
5    environment: 
6      - PUID=1000
7      - PGID=1000
8      - TZ=${TZ}
9      - PASSWORD=${PASSWORD}
10    volumes: 
11      - librespeed_config:/config
12    ports: 
13      - "8080:80"
14    restart: unless-stopped
15    networks: 
16      - librespeed-network
17
18volumes: 
19  librespeed_config: 
20
21networks: 
22  librespeed-network: 
23    driver: bridge

.env Template

.env

1# LibreSpeed
2TZ=UTC
3PASSWORD=your_results_password

Usage Notes

1Test page at http://localhost:8080
2No external dependencies
3Results storage optional
4Measures local network speed
5HTML5 based

Quick Start

terminal

1# 1. Create the compose file
2cat > docker-compose.yml << 'EOF'
3services:
4  librespeed:
5    image: linuxserver/librespeed:latest
6    container_name: librespeed
7    environment:
8      - PUID=1000
9      - PGID=1000
10      - TZ=${TZ}
11      - PASSWORD=${PASSWORD}
12    volumes:
13      - librespeed_config:/config
14    ports:
15      - "8080:80"
16    restart: unless-stopped
17    networks:
18      - librespeed-network
19
20volumes:
21  librespeed_config:
22
23networks:
24  librespeed-network:
25    driver: bridge
26EOF
27
28# 2. Create the .env file
29cat > .env << 'EOF'
30# LibreSpeed
31TZ=UTC
32PASSWORD=your_results_password
33EOF
34
35# 3. Start the services
36docker compose up -d
37
38# 4. View logs
39docker compose logs -f

One-Liner

Run this command to download and set up the recipe in one step:

terminal

1curl -fsSL https://docker.recipes/api/recipes/librespeed-test/run | bash

Troubleshooting

Speed test shows much lower results than expected: Check if the Docker host has sufficient CPU and network bandwidth to handle the test load, consider adjusting chunk sizes in LibreSpeed configuration
Test fails with connection timeout errors: Verify port 8080 is accessible from client networks and not blocked by firewalls, check Docker container logs for binding issues
Admin panel login fails despite correct password: Ensure PASSWORD environment variable is properly set and container has been restarted after configuration changes
Mobile devices show different results than desktop: This is normal due to device processing differences, ensure mobile browsers support HTML5 features required by LibreSpeed
Historical results not saving in telemetry: Check that the config volume has proper write permissions and sufficient disk space for the SQLite database
Multiple concurrent tests interfere with each other: LibreSpeed can handle multiple simultaneous tests but results may vary, consider implementing usage guidelines for shared environments

Community Notes

Loading notes...

Download Recipe Kit

Get all files in a ready-to-deploy package

Includes docker-compose.yml, .env template, README, and license

Components

librespeed

Related Recipes

Ad Space

Shortcuts: C CopyF FavoriteD Download