How do I install iPerf3 in QTS and QuTS hero?

Last modified date: 2026-08-27

Applicable Products

QTS 4.3.6 (or later)

QuTS hero 4.5.0 (or later)

Solution

iPerf3 can be installed on a QNAP NAS in either of two ways: as a container in Container Station, or using an Entware QPKG file.

Method 1: Run iperf3 in Container Station

1. Open the App Center, then search for and install Container Station.

2. On first launch, complete the setup wizard and specify the storage location for container data.

3. In Container Station, select Create > Create Application, then enter the following Docker Compose configuration:

 services:
   iperf3:
     image: loganmarchione/docker-iperf3
     container_name: iperf3
     restart: unless-stopped
     ports:
       - "5201:5201/tcp"
       - "5201:5201/udp"

Refer to the documentation for the loganmarchione/docker-iperf3 image for its supported environment variables and parameters. To have the NAS act as the iPerf3 client rather than the server, or to use host network mode for more accurate results, adjust the configuration accordingly.

4. Click Validate to verify the correctness of the yaml code.

5. Click Create and wait for the image to be pulled and the container to start.

6. Confirm the container status is Running.

7. iPerf3 is now ready to use on your NAS.

Method 2: Install iperf3 in using an Entware QPKG File

Download Entware_1.02std.qpkg.
Install the QPKG file:
1. Open the App Center.
2. Click Install Manually.
3. Click Browse and select the QPKG file you downloaded.
4. Click Install.
5. Tick the checkbox I understand the risks and want to install this application and click Install
6. Check that Entware-std 1.02 is installed in the App Center.
7. Log in to the NAS command line via SSH.
8. Change the directory to the folder that the QPKG is installed in - for example:
  # cd /share/CACHEDEV1_DATA/.qpkg/Entware/bin
9. Run the following command to install iPerf3:
  # ./opkg install iperf3
10. iPerf3 can now be used on your NAS.