---
title: "Install k6 | Grafana Labs"
description: "Install k6 on your machine using your preferred package manager or download method."
---

> For a curated documentation index, see [llms.txt](/llms.txt). For the complete documentation index, see [llms-full.txt](/llms-full.txt).

# Install k6

In this milestone, you install k6 on your machine using your preferred package manager and verify that it is working as expected.

1. Choose the installation method for your operating system:
   
   Expand table
   
   | OS                        | Method                      |
   |---------------------------|-----------------------------|
   | **macOS**                 | Homebrew                    |
   | **Linux (Debian/Ubuntu)** | APT                         |
   | **Linux (Fedora/CentOS)** | DNF/YUM                     |
   | **Windows**               | Chocolatey or Winget        |
   | **Any platform**          | Docker or standalone binary |
2. **In your terminal**, install k6 using your chosen method.
   
   For macOS:
   
   Bash ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
   
   ```bash
   brew install k6
   ```
   
   For Linux (Debian/Ubuntu):
   
   Bash ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
   
   ```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 Docker:
   
   Bash ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
   
   ```bash
   docker pull grafana/k6
   ```
3. Verify the installation by checking the k6 version:
   
   Bash ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
   
   ```bash
   k6 version
   ```
   
   You should see version information displayed in your terminal.

**Troubleshooting**

Explore the following troubleshooting topic if you need help:

- [k6 installation troubleshooting guide](/docs/k6/latest/set-up/install-k6/troubleshooting/)

In the next milestone, you write your first k6 test script with HTTP requests and checks.