What is speedtest-rust?

speedtest-rust is the Rust backend for LibreSpeed, a self-hosted speed test platform with no Flash, Java, or WebSocket dependencies. It provides download, upload, ping, and jitter measurements along with IP address and ISP detection using an offline ipinfo.io database. Optional features include telemetry collection and results sharing. The server runs on any Rust-supported platform and can use PostgreSQL or MySQL to store test results. Installation options include prebuilt binaries for multiple architectures, Debian packages, Docker Compose, and compiling from source with Rust 1.74+. The project includes a built-in web frontend and is compatible with LibreSpeed's web, CLI, Android, and desktop clients.

Should you self-host speedtest-rust?

speedtest-rust scores 45/100 on selfhost.directory (how scoring works) and ranks #35 of 48 in Network Monitoring. It has 252 GitHub stars.

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is moderate: expect some configuration beyond a single command. It is LGPL-3.0-licensed and written mostly in Rust.

Its closest alternative on selfhost.directory is mitmproxy (86/100, 46 446 stars). It scores higher overall, so compare the two before you pick. See speedtest-rust vs mitmproxy side by side.

Features

Debian packages
Download Speed Test
In-memory database
IP address and ISP detection
Jitter measurement
Multiple architecture binaries
Ping measurement
Results SharingOptional feature
Systemd service integration
Telemetry collectionOptional feature
TLS Support
Upload Speed Test

How to install speedtest-rust

Install speedtest-rust with Docker Compose

Install docker and docker-compose.
Clone the repository:

$ git clone https://github.com/librespeed/speedtest-rust.git
$ cd speedtest-rust

Copy the default config and assets:

$ cp docker-compose.override.sample.yml docker-compose.override.yml
$ sudo mkdir /var/lib/librespeed
$ sudo cp configs.toml /etc/librespeed.toml
$ sudo cp -r assets /var/lib/librespeed/assets

Edit the config files:

$ sudo chmod o-rwx /etc/librespeed.toml docker-compose.override.yml # Hide secrets
$ $EDITOR docker-compose.override.yml # Docker settings
$ sudo $EDITOR /etc/librespeed.toml # Librespeed settings

Start the container:

$ docker compose up -d
$ docker compose logs -f # To check status

Navigate to http://localhost:8080/

Requires Docker and Docker Compose installed

Install speedtest-rust with Linux

Download the appropriate binary file from the releases page.
Unzip the archive.
Make changes to the configuration.
Run the binary.
Or setup as service:
- Copy setup_systemd.sh on linux or setup_sc_win.bat on windows system in extracted folder.
- Run the script file to setup as service

Prebuilt binaries available for multiple architectures and OSes

Install speedtest-rust with Debian

Download the deb package file from the releases page.
Install it.
Enable systemd service:

$ sudo systemctl enable speedtest_rs.service

Edit configs file:

$ sudo nano /var/lib/librespeed-rs/configs.toml

Use systemd to manage librespeed service:

$ sudo service speedtest_rs start
$ sudo service speedtest_rs stop
$ sudo service speedtest_rs status

For Debian-based Linux distributions

Install speedtest-rust with Build from Source

You need Rust 1.74+ to compile project.

Clone the repository:

$ git clone https://github.com/librespeed/speedtest-rust.git

Build:

# cd to cloned directory
$ cargo build --release

Prepare files:

# Make a new directory
# Copy target/release/librespeed-rs to created directory
# Copy configs.toml to created directory
# If you want the server to load the speedtest web front in the route `/`, then you must specify the path of the client folder in the configs.toml file.

Requires Rust 1.74+