1. Home
  2. Linux

How To Run SpeedTest From The Linux Terminal

Speedtest.net is a handy tool for Linux server admins and enthusiasts as it helps them quickly test ping, bandwidth, and other network information from the comfort of a website. Still, for as good as the Speedtest.net website is, it’s not very useful if you’re trying to test the internet connection of a remote server and don’t have access to a web browser.

Introducing Speedtest-cli: it’s a command-line utility that lets you run Speedtest from the Linux terminal. It does everything that the Speedtest website does but with Linux command arguments. To install this software, you’ll need the latest version of the Python programming language.

Install Speedtest-cli

Speedtest-Cli is installable via many different Linux distribution’s software sources. It is also available via the source code or the Python Package tool.


sudo apt install speedtest-cli


sudo apt-get install speedtest-cli

Arch Linux

Arch users looking to install Speedtest-cli will need to first enable the “Community” software repository in /etc/pacman.conf. To activate, launch a terminal and open pacman.conf with Nano.

sudo nano /etc/pacman.conf

Scroll down and find “Community.” Remove all instances of # from in front of “Community,” and the lines underneath it as well. After removing the # symbols, press Ctrl + O to save the edits, and exit Nano with Ctrl + X.

Re-sync your Pacman to enable the Community repo.

sudo pacman -Syy

With the Community rep now up and running on your Arch Linux PC, install the speedtest-cli utility.

sudo pacman -S speedtest-cli


sudo dnf install speedtest-cli -y


sudo zypper install speedtest-cli

Generic Linuxes Via Python PIP

If you can’t get the Speedtest-cli utility, you’ll be able to get it going with Python and PIP. To start the installation, open up a terminal window and ensure you have the latest version of both Python and Pip. When you’ve determined you have the newest version of Python and Pip working on your Linux PC, install Speedtest-cli with the following command.

Note: do not try to use sudo during the installation, as it will mess up your Python development environment.

pip install speedtest-cli

Generic Linuxes via building from source

Going the Python Pip route on generic Linux distributions is usually the easiest way to get it going if your Linux distribution doesn’t care the software. However, if PIP doesn’t work, there’s another solution: building from source.

Before installing Speedtest-cli via the Github source code, install the Python programming language, as well as the Git tool. Then, use the git clone command to grab the code.

git clone https://github.com/sivel/speedtest-cli.git

Move your terminal into the speedtest-cli code folder and update the contents’ permissions.

sudo chmod +x *

Run the installation tool to get Speedtest-cli working on your Linux PC.

python setup.py install

Use Speedtest-Cli

To run a basic internet speed test with the Speedtest-cli tool, launch a terminal, and run speedtest-cli in it. What follows is a basic test of your ping, upload, and download speed. The results of your internet test will show up in text form when the process is complete.


If you’re new to using the terminal and wish internet test results were easier to read, add the simple modifier to speedtest-cli commands.

speedtest-cli  --simple

Download-only Test

Want to figure out your download speed but don’t feel like running a full internet speed test? Try running the speedtest-cli command with the no-upload modifier.

speedtest-cli --no-upload

Combine no-upload with the simple modifier for an easy to read experience.

speedtest-cli --no-upload --simple

Upload-only Test

Running speedtest-cli with the no-download command will allow the user to do an “upload only” test.

speedtest-cli --no-download

For best results, run with the simple modifier.

speedtest-cli --no-download --simple

View Graphical Results

When you run an internet speed test on Speedtest.net, you have the option of viewing your network results in a PNG image. If you want a picture result of speed tests you run with speedtest-cli in the terminal, add the share modifier.

speedtest-cli --share --simple

Speedtest With Bytes

Each internet test you run with the speedtest-cli command is measured in bits. It’s the universal standard for measuring speed on the internet. If this doesn’t sit right with you, consider using the bytes modifier in your tests.

speedtest-cli --bytes

Export SpeedTest To CSV

Do you run speed tests a lot? Want to keep track of your data? Consider running the speedtest-cli command with the csv modifier. Using this feature prints out test results in the “csv” text format which is easily pasteable in spreadsheet programs like Microsoft Excel or Libre Office Calc.

speedtest-cli --csv

Other Speedtest-cli Features

In this tutorial, we go over many different useful features that you can use with speedtest-cli. Though, there are many other useful features that we haven’t covered.

To access the other Speedtest command-line features, run the following command in a terminal window.

speedtest-cli --help

Alternatively, save the help page to a text file with:

speedtest-cli --help >> ~/Documents/speedtest-cli-commands.txt

Leave a comment