Use iPerf3 on macOS to check community bandwidth and throughput.
iPerf3 is a community throughput software used to measure the efficiency of the community your Mac is utilizing. Here is learn how to use it within the macOS Terminal app.
iPerf (typically merely referred to as “iperf”) is a UNIX reminiscence, community throughput, and bandwidth software first developed on the NCSA of the College of Illinois. iPerf is a completely suitable rewrite of the older Check TCP (ttcp) app initially written on the US Military’s Ballistic Analysis Lab for DARPA in round 1983.
There are additionally fashionable variations for Home windows and Linux.
There are three revisions of iPerf, and the third revision (iperf3) is not backward suitable with earlier variations. iperf3 was first launched in 2014 and in addition features a developer library so different applications can use it.
In contrast to earlier variations, iperf3 is single-threaded whereas the sooner variations had been multi-threaded. Multi-threading merely means a couple of code path can run concurrently on computer systems which have a number of CPUs or multi-core CPUs. Multi-threading is utilized in parallel processing and improves efficiency.
The iperf3 rewrite was undertaken by the US Dept. of Power’s Power Sciences Community (ESN) and Lawrence Livermore Lab in Livermore, CA to enhance efficiency. ESN connects a number of analysis and business labs worldwide.
iperf3 supply code may be discovered on GitHub at esnet / iperf.
The unique iperf2 codebase written by Robert McMahon may be discovered on Sourceforge.
There may be additionally a really detailed Iperf 2 & Iperf 3 Comparability Desk at SourceForge.
Objective
iperf3 is a memory-to-memory measurement software, however it’s generally used to measure community and router efficiency, and even storage gadgets. In contrast to iPerf2, model 3 additionally offers output in JSON format.
All iPerf variants require each a server and a consumer part for testing. iperf3 makes use of TCP and UDP (connection-less) protocols for testing and communication.
Though iperf3 just isn’t backward suitable, iperf2 and iperf3 instructions are very related. ESN has an iperf2/iperf3 command chart.
ESN has a comparability chart which summarizes the choice variations between instruments. There may be additionally a macOS tuning web page which describes learn how to optimize your community and settings to make use of iperf3.
The principle makes use of for iperf3 are to measure reminiscence efficiency between techniques, and community connections, bandwidth, disk efficiency, and throughput throughout networks.
Set up on macOS
iperf3 just isn’t included with macOS by default. The simplest solution to set up it’s to make use of the Homebrew package deal supervisor and the Homebrew iperf3 method.

Putting in iperf3 utilizing Homebrew.
As soon as Homebrew is put in in your Mac, open Apple’s Terminal app positioned in your Startup Disk within the /Purposes folder and easily kind:
brew set up iperf3
and press Return in your keyboard.
The Homebrew implementation of iperf3 depends on a number of different Homebrew packages which might be put in mechanically:
- cfnctl
- comrak
- gauth
- ggh
- hcledit
- ramalama
- yices2
You may examine these on their respective Homebrew method pages. You may test the put in model of iperf3 in Terminal with:
iperf3 -v
Working iperf3 in Terminal
There are a big selection of choices when operating iperf3 in Terminal on macOS, however the easiest command is:
iperf3 -c remotehost
the place ‘remotehost’ is the IP tackle or identify of the server you wish to connect with. Bear in mind, the iperf3 server part have to be operating and listening on the pc you are attempting to hook up with.
The -c
possibility tells iperf3 to run in consumer mode and to hook up with the required server. To connect with the distant pc utilizing UDP as a substitute of TCP, use the -u
possibility together with -c
:
iperf3 -c -u remotehost
Further choices
There are dozens of different choices together with:
- -p (port quantity)
- -f (velocity label format)
- -i (interval in seconds)
- -B (bind to a particular community interface)
- -V (verbose output)
- -J (JSON output)
- -l (log file output)
- -d (debug mode)
- -h (present assist)
In case you are operating your individual iperf3 server, use the -s
or -D (daemon) flag to begin the server. When operating in server mode there may be additionally a --authorized-users-path
flag to set what customers to permit.
By default, the iperf3 server listens on TCP port 5201 for connections from an iperf3 consumer. A unique port may be specified utilizing the -p
flag adopted by an area, then the port quantity. For instance:
iperf3 -s -p 5002
This command begins iperf3 in server mode and listens on UNIX port 5002 for incoming requests from shoppers.
You would possibly wish to use an alternate port as a substitute of the usual port to create a non-public server. This may alsoo assist safe your server in opposition to dangerous actors who frequently goal normal server ports as a solution to break right into a machine.
For an entire checklist of iperf3 utilization and choices in Terminal use the person (handbook) system:
man iperf3
adopted by a Return in your keyboard.
Terminal output
As soon as operating, iperf3 will show check ends in the Terminal with every check line exhibiting the check interval (delay in seconds), quantity of information, and total throughput. To cease the exams press Command Z or q in your keyboard.
When you used the UDP (-u
) possibility the exams may even present any packet loss.

Working an iperf3 check in Terminal.
There may be additionally an iperf3 Improvement web page.
iperf.fr in France additionally has loads of nice data, together with an inventory of check servers.
A devoted checklist of free iperf3 check servers is accessible at iPerf3 Server Record, however typically the load on the positioning is so nice it is unreachable.
For one more helpful networking software try NetPipe.
iperf3 is easy to put in and use (and is very easy to run) the subsequent time you want a fast bandwidth check throughout a community you will marvel how you bought alongside with out it.