mm404/iperf3 repository overview

⁠iperf3

A lightweight multi-arch Docker image for iperf3, the network performance measurement tool, based on Alpine Linux.

⁠Supported Architectures

• linux/amd64
• linux/arm64
• linux/arm/v7

⁠Supported Tags

• latest
• <iperf3 version> (eg, 3.17.1)
• <iperf3 version>-alpine (eg,3.17.1-alpine)
• <iperf3 version>-alpine<version> (eg,3.17.1-alpine3.21.0)

⁠Quick Start

⁠Server Mode

docker run -d --name iperf3-server -p 5201:5201 -p 5201:5201/udp mm404/iperf3 -s

⁠Client Mode

docker run --rm mm404/iperf3 -c <server-ip>

⁠Usage Examples

⁠Basic TCP Test

# On server
docker run -d --name iperf3-server -p 5201:5201 mm404/iperf3 -s

# On client
docker run --rm mm404/iperf3 -c <server-ip> -t 30

⁠UDP Test

# On server
docker run -d --name iperf3-server -p 5201:5201/udp mm404/iperf3 -s

# On client
docker run --rm mm404/iperf3 -c <server-ip> -u -b 100M

⁠Common Options

• -s: Run in server mode
• -c <host>: Run in client mode, connecting to <host>
• -p <port>: Server port to listen on/connect to (default 5201)
• -t <time>: Time in seconds to transmit (default 10 secs)
• -u: Use UDP instead of TCP
• -b <bandwidth>: Target bandwidth in bits/sec (default 1 Mbit/sec for UDP)
• -P <num>: Number of parallel client streams
• -R: Run in reverse mode (server sends, client receives)

⁠Security

The container:

• Runs as non-root user iperf
• Is based on Alpine Linux for minimal attack surface
• Receives regular security updates through automated builds (Renovate)

⁠License

This project is licensed under the MIT License.

⁠Contributing

Feel free to open issues and pull requests in the GitHub repository⁠.

⁠Maintainer

Maintained by MM503 (jostles-felts-0f[at]icloud.com)