Install k6

In this milestone, you install k6 on your machine. k6 has packages for Linux, macOS, and Windows, and you can also use a Docker container or download a standalone binary.

The installation method you choose depends on your operating system and preferences. k6 supports native installation via package managers for the best performance, or Docker for containerized environments.

To install k6, complete the following steps:

  1. Choose your installation method based on your operating system:

    Operating systemInstallation method
    Linux (Debian/Ubuntu)APT package manager
    Linux (Fedora/CentOS)DNF/YUM package manager
    macOSHomebrew
    WindowsChocolatey, Winget, or MSI installer
    Any platformDocker container or standalone binary
  2. Install k6 using your chosen method:

    For Linux (Debian/Ubuntu):

    Bash
    sudo gpg -k
    sudo gpg --no-default-keyring --keyring /usr/share/keyrings/k6-archive-keyring.gpg --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys C5AD17C747E3415A3642D57D77C6C491D6AC1D69
    echo "deb [signed-by=/usr/share/keyrings/k6-archive-keyring.gpg] https://dl.k6.io/deb stable main" | sudo tee /etc/apt/sources.list.d/k6.list
    sudo apt-get update
    sudo apt-get install k6

    For Linux (Fedora/CentOS):

    Bash
    sudo dnf install https://dl.k6.io/rpm/repo.rpm
    sudo dnf install k6

    For macOS:

    Bash
    brew install k6

    For Windows (Chocolatey):

    powershell
    choco install k6

    For Windows (Winget):

    powershell
    winget install k6 --source winget

    For Docker:

    Bash
    docker pull grafana/k6

    For Binary: Download the latest binary from the GitHub Releases page. For detailed steps, see Install k6 - Binary.

  3. Verify the installation by checking the k6 version:

    Bash
    k6 version

    If k6 is installed correctly, you should see version information displayed in your terminal.

    If you encounter installation issues, refer to the k6 installation troubleshooting guide.

In the next milestone, you’ll write your first k6 test script to perform HTTP requests and measure performance.


page 3 of 8