1. Introduction to Speedtest CLI
Speedtest CLI is a command-line tool for testing internet speed regarding download, upload, and latency (ping). This software allows users to quickly and accurately measure and assess network performance, helping them better understand their internet connection status. With advantages of speed and accuracy, Speedtest CLI is the ideal choice for those who need to frequently test network speed with specific parameters.
The outstanding advantage of Speedtest CLI compared to the Speedtest web version is the ability to perform remote tests without needing to open a browser, saving time and providing more accurate results, especially in enterprise environments. Users of Speedtest CLI are usually network administrators, IT engineers, and tech-savvy users who require regular network speed testing.
2. Installing Speedtest CLI
Installing Speedtest CLI on Windows
To install Speedtest CLI on Windows, you need to follow these steps:
- Download and install Speedtest CLI for Windows from the official Ookla website.
- Add Speedtest CLI to PATH for easy access from Command Prompt.
Installing Speedtest CLI on macOS
On macOS, you have two installation methods:
- Installation via Homebrew: Use the command
brew install speedtest-cliin Terminal for quick installation, this is the recommended method. - manual installation: Download the installation file and follow the instructions on the official site.
Installing Speedtest CLI on Linux
For Linux operating systems like Ubuntu, Debian, or CentOS:
- Installation via APT/YUM: Use the command corresponding to each operating system for installation.
- Installation from .deb/.rpm file: Download and install the file according to the respective instructions for each operating system.
3. Basic Usage of Speedtest CLI
The command syntax of Speedtest CLI is very simple. You just need to open Command Prompt or Terminal and type the command speedtest to perform the test. The results will immediately display download speed, upload speed, and ping.
The meanings of the parameters are:
- Download: The speed of downloading data from the internet.
- Upload: The speed of uploading data to the internet.
- Ping: The response time between your device and the server.
4. Advanced Options of Speedtest CLI
Speedtest CLI offers many advanced options for professional users:
- Select a specific server to test speed, enhancing accuracy.
- Display the ID of the server for easier management.
- Test network speed in Mbps or Kbps as needed.
- Save results to a file for later reference or reporting.
- Use commands to schedule automatic network speed tests.
5. Troubleshooting Common Issues When Using Speedtest CLI
During the use of Speedtest CLI, some common errors may occur:
- Error “speedtest” is not recognized: the folder containing speedtest.exe isn’t in your PATH. Run the command from the folder you extracted it to, or add that folder to PATH (System Properties > Environment Variables).
- Prompt to accept the licence/GDPR terms: on first run, type
YES, or add--accept-license --accept-gdprwhen running it in a script. - “Cannot read from socket” / “Timeout”: a firewall, proxy or corporate network is blocking the test servers. Pick another server with
-s <server_id>(list them withspeedtest -L) or check the firewall. - Unusually low results: testing over weak Wi-Fi, other devices downloading, or a distant server. Test again over Ethernet, close background apps and choose a nearby server.
- Installation fails on Linux: remove the older unofficial Python package
speedtest-clibefore installing Ookla’sspeedtestpackage, as they conflict on the command name.
6. Reading Speedtest CLI results
- Idle Latency (ping): delay when the network is idle; under 20 ms is good to a nearby server.
- Download/Upload: speeds in Mbps. Compare with your plan; Wi-Fi results are usually noticeably lower than wired.
- Jitter: variation in latency; lower is better for video calls and VoIP.
- Packet Loss: should be 0%. Persistent loss points to a problem with the line or network equipment.
- Result URL: a link to the result that you can send your ISP when complaining.
7. Using it in a business
Because Speedtest CLI needs no interface, it’s ideal for scheduled tests on servers, NAS devices or branch PCs. For example, export results as CSV (speedtest -f csv) and run it hourly with Task Scheduler (Windows) or cron (Linux) to collect evidence of peak-hour slowdowns — useful when dealing with your ISP or deciding to upgrade the plan or add a backup line.
8. Conclusion
Speedtest CLI is a quick, accurate and automatable way to measure Internet speed. Install the official Ookla version, choose an appropriate server and log results regularly to track network quality instead of relying on impressions.
If you need assistance, please contact us right away
IT SYSTEMS VIETNAM CO., LTD
IT Solutions – Your Business IT Department
HOTLINE: 028.3995.03.59
Email: contact@itsystems.com.vn
Website: https://itsystems.vn/
Facebook: https://www.facebook.com/ITSystems.VIETNAM
Youtube: https://www.youtube.com/@ITSYSTEMS
HCM: 14/33 Dao Duy Anh, Duc Nhuan Ward, Ho Chi Minh City, Vietnam
HCM: 321/10 Phan Dinh Phung, Cau Kieu Ward, Ho Chi Minh City, Vietnam.
Hanoi: House No. 22, Garden Villa Area, Vinh Hoang Urban Area, 431 Tam Trinh Street, Hoang Mai District, Hanoi, Vietnam.
FAQ
How does Speedtest CLI differ from a browser test?
The CLI is scriptable, runs on headless servers and exports JSON or CSV, so results can be logged and compared over time.
My result is below my plan. Is the ISP failing its promise?
Not necessarily. Test over cable, stop other downloads, pick a nearby server and repeat at different times before concluding.
Can speed tests be scheduled automatically?
Yes. Use Task Scheduler on Windows or cron on Linux to run speedtest regularly and log the output to a file.
Unstable office network that needs redesigning?
IT Systems surveys, designs and deploys LAN, Wi-Fi, firewall and VPN for offices and branches, with full documentation.




