speedtest1
Command line interface for testing internet bandwidth using speedtest.net
Part of speedtest-cli(1).
Usage
speedtest-cli [OPTION ...]
Overview
Speedtest.net is a web service for testing your broadband connection by downloading a file from a nearby speedtest.net server on the web. This tool allows you to access the service from the command line.
Speedtest mini is a version of the Speedtest.net server that you can host locally.
Options
Usage: speedtest-cli [OPTION...]
Help Options
-
-h, --help -
Displays usage for the tool.
Options
-
--no-download -
Do not perform download test
-
--no-upload -
Do not perform upload test
-
--single -
Only use a single connection instead of multiple. This simulates a typical file transfer.
-
--bytes -
Display values in bytes instead of bits. Does not affect the image generated by --share, nor output from --json or --csv
-
--simple -
Suppress verbose output, only show basic information
-
--csv -
Suppress verbose output, only show basic information in CSV format. Speeds listed in bit/s and not affected by --bytes
-
--csv-delimiter CSV_DELIMITER -
Single character delimiter to use in CSV output. Default ","
-
--csv-header -
Print CSV headers
-
--json -
Suppress verbose output, only show basic information in JSON format. Speeds listed in bit/s and not affected by --bytes
-
--list -
Display a list of speedtest.net servers sorted by distance
-
--server SERVER -
Specify a server ID to test against. Can be supplied multiple times
-
--exclude EXCLUDE -
Exclude a server from selection. Can be supplied multiple times
-
--mini MINI -
URL of the Speedtest Mini server
-
--source SOURCE -
Source IP address to bind to
-
--timeout TIMEOUT -
HTTP timeout in seconds. Default 10
-
--secure -
Use HTTPS instead of HTTP when communicating with speedtest.net operated servers
-
--no-pre-allocate -
Do not pre allocate upload data. Pre allocation is enabled by default to improve upload performance. To support systems with insufficient memory, use this option to avoid a MemoryError
-
--version -
Show the version number and exit
Examples
Automatically find closest server and start testing
speedtest-cli
Specify testing against server 1491
speedtest-cli --server 1491
Testing against Speedtest Mini
speedtest-cli --mini 172.18.66.1
History
- Debian 13 (Trixie) to Debian 11 (Bullseye): the text shown here
- Debian 10 (Buster)
- Debian 9 (Stretch)
- Debian 8 (Jessie)
--csv since Debian 9 (Stretch);
--csv-delimiter since Debian 9 (Stretch);
--csv-header since Debian 9 (Stretch);
--exclude since Debian 10 (Buster);
--json since Debian 9 (Stretch);
--no-download since Debian 10 (Buster);
--no-pre-allocate since Debian 10 (Buster);
--no-upload since Debian 10 (Buster);
--secure since Debian 9 (Stretch);
--single since Debian 11 (Bullseye);
--timeout since Debian 9 (Stretch).