Install k6

Install k6 with the method that matches your operating system. Native packages work well for most learners; Docker and standalone binaries are available if you prefer them.

To install k6, complete the following steps:

  1. Choose your installation method:

    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