iperf3: Local Router Speedtest
Objective
To measure the actual network throughput between two devices connected to the same local router using iperf3
.
What is iPerf3?
iPerf3 is a command-line tool for measuring network bandwidth. It works using a client-server model and can test both upload and download speeds across TCP and UDP protocols.
Requirements
Two devices connected to the same local network (wired or wireless)
iperf3
installed on both devicesAccess to a terminal or command prompt
Installation
Ubuntu/Debian
sudo apt update
sudo apt install iperf3
macOS (Homebrew)
brew install iperf3
Android (Termux)
pkg install iperf3
Windows
Download from: https://iperf.fr/iperf-download.php
Test Setup
iPerf3 operates with one device as the server and the other as the client.
Step-by-Step Test
1. Start the Server
On Device A (e.g., your laptop or Raspberry Pi):
iperf3 -s
This will start the iPerf3 server and wait for incoming connections.
2. Run the Client
On Device B, determine the IP address of Device A, then run:
iperf3 -c <server_ip_address>
Example:
iperf3 -c 192.168.1.10
This runs a default 10-second test from client to server.
3. Test in Reverse (Optional)
To test bandwidth from server to client:
iperf3 -c 192.168.1.10 -R
Understanding the Results
Focus on the Bandwidth column (in Mbits/sec).
The value represents the actual throughput between the devices.
Expect variations based on Wi-Fi vs Ethernet, signal strength, and router quality.
Additional Options
Option
Description
-t <seconds>
Change test duration (default: 10s)
-P <number>
Use multiple parallel connections
Examples:
iperf3 -c 192.168.1.10 -t 30
iperf3 -c 192.168.1.10 -P 4
Conclusion
iPerf3 is a simple yet effective tool to test the real network speed between two devices on the same local network. It helps identify potential bottlenecks in routers, cables, or wireless connections.
Last updated