LibreSpeed measures the speed between your device and your server, from any browser. It's the quickest way to find out whether it's the Wi-Fi, the VPN or the internet that's slow.
On this page
Good to know before you install
Each test's IP address and ISP are saved on this server in the results history, so anyone who runs a test is recorded
At a glance#
- What it is
- Network Performance Monitoring Networking
- Where it opens
- Speedtest
On its own port at
http://your-server:port, orspeedtest.your-domainonce you have a domain - Updates
- Automatic A backup is taken first, and it rolls back if the update fails
- Backups
- Left out Not in the scheduled backups unless you switch it on
- Copies
- As many as you like Run several copies, each with its own data
What it's good for#
Ordinary speed test sites measure your connection to somewhere on the internet. LibreSpeed measures the connection between whatever device you're holding and your own server. That answers different, and often more useful, questions:
- At home: is the Wi-Fi in the back bedroom the problem? Run it there and next to the router and compare.
- Away, over the VPN: how fast can you actually reach your server from outside? With a home server, that's mostly your home internet's upload speed, and it's what decides whether streaming from Jellyfin away from home will work.
- On a VPS: how good is the route from your home to the server?
Using it#
Open it with the Speedtest button and press Start. It measures download, upload, ping and jitter, with no account and nothing to install, so it works the same on a phone as on a laptop.
Past results#
Every test is saved on the server, so you can compare over time. The Results button opens the results page, which asks for a password. It's in the Login Details shown when the install finished; press Welcome on the app's page to see it again. There's no username, just the password.
Turning the password off
The results page's password can be switched off with CFG_SPEEDTEST_PASSWORD_ENABLED=false (see settings in the config file), which leaves the results open to anyone who can reach LibreSpeed. The Login Details still show a password after that, but it no longer does anything.
Good to know#
- Its results are about your server's connection, not your internet connection in general. For that, use an ordinary speed test site.
- A small server can be the limit itself. At gigabit speeds, a low-powered machine's processor may run out before the network does, so a result that stops short of what your network should manage may be the server, not the network.
- It's public to start with, so anyone who finds it can run a test, which uses your bandwidth. Private is the sensible choice unless you want to test from somewhere that isn't one of your trusted places and can't use the VPN.
- It's left out of backups, as its history of results isn't worth keeping. Switch backups on in its settings if you'd like it kept.
- More than one copy is possible, though one is usually plenty.
Addresses and ports#
LibreSpeed has one port. LibrePortal picks a free port number for each when you install, so yours will differ from anyone else's. The Config tab's Network section shows them, and the app's Open button uses the right one. "Anyone" means it's reachable from wherever your server is reachable; you can make it private later.
| What it is | Who can reach it | With a domain |
|---|---|---|
| Speedtest, Results | Anyone | speedtest.your-domain |
Settings#
In its config file#
LibreSpeed's own settings aren't on the Config tab yet. They live in the app's config file, described here so you know they exist. How to change them.
| Setting | What it does | Starts as |
|---|---|---|
NameCFG_SPEEDTEST_DISPLAY_NAME |
What this app is called on your dashboards. Leave empty to use its usual name | Empty |
Show on the LibrePortal DashboardCFG_SPEEDTEST_SHOW_ON_DASHBOARD |
Whether this app gets a shortcut on the front page of the LibrePortal WebUI, separate from any Dashy dashboard Choices: true, false |
false |
Detailed logsCFG_SPEEDTEST_VERBOSE_LOGS |
Whether Speedtest writes its normal, chattier logs, including who connected, instead of only warnings and errors. Choices: true, false |
false |
Debug logging for 24 hoursCFG_SPEEDTEST_DEBUG_LOGS |
Turn on to see everything Speedtest is doing while you look for a problem; it turns itself off after 24 hours. Choices: true, false |
false |
Works with#
These are the other apps LibreSpeed knows how to work with. Once it's installed, its page shows the same list with whether each one is connected. How this works.
- Grafana: Shows dashboards for the apps that have one. works with every app
- Prometheus: Collects metrics from the apps that can export them. works with every app
- Uptime Kuma: Watches your apps and shows when one goes down. works with every app
Privacy and security#
All clear LibreSpeed measures your internet or network speed. It keeps test results on your own server and does not send them to anyone.
What leaves this server#
- Results (including the tester's address and provider) are stored on your server, behind a password
What LibrePortal turns off#
Nothing needed switching off.
Licence: LGPL-3.0 (LibreSpeed). Audited: 21 October 2026. See the privacy of every app and the Promise.
Sources#
Under the hood#
- It runs this image:
lscr.io/linuxserver/librespeed:6.3.0@sha256:03380ad93dea90c672036851a2697666daa0a2e68558aa84b11a679946b57a7c. - It can sit behind Authelia's sign-in once Authelia is installed.
- Its own project and documentation: github.com/librespeed/speedtest
Ports, settings, tools and connections on this page are read from LibrePortal v0.10.97's app catalogue each time the guide is built.