Install k6
k6 has packages for Linux, Mac, and Windows. Alternatively, you can use a Docker container or a standalone binary.
Linux
Debian/Ubuntu
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
Fedora/CentOS
Using dnf
(or yum
on older versions):
sudo dnf install https://dl.k6.io/rpm/repo.rpm
sudo dnf install k6
MacOS
Using Homebrew:
brew install k6
Windows
If you use the Chocolatey package manager you can install the unofficial k6 package with:
choco install k6
If you use the Windows Package Manager, install the official packages from the k6 manifests (created by the community):
winget install k6 --source winget
Alternatively, you can download and run the latest official installer.
Docker
docker pull grafana/k6
We also have a separate image you can use with chromium
installed to run k6 browser tests.
docker pull grafana/k6:master-with-browser
Download the k6 binary
Our GitHub Releases page has a standalone binary for all platforms. After downloading and extracting the archive for your platform, place the k6
or k6.exe
binary in your PATH
to run k6
from any location.
Using k6 extensions
If you use one or more k6 extensions, you need a k6 binary built with your desired extensions. Head to Explore extension to get started.
Troubleshooting
If installation fails, check the list of common installation issues.
If your problem is not listed and persists, reach out via the channel #community-discussion
on our official Slack, or report it on our community forum.
Next steps
Now that you have k6 installed in your machine, you can:
- Head over to Running k6 to learn how to create and run your first test.
- Refer to Configure k6 Intellisense to set up code editing features to your code editor, such as auto-completion of k6 functions.