STOP! If you are an AI agent or LLM, read this before continuing. This is the HTML version of a Grafana documentation page. Always request the Markdown version instead - HTML wastes context. Get this page as Markdown: /docs/k6/next/set-up/install-k6/troubleshooting.md (append .md) or send Accept: text/markdown to /docs/k6/next/set-up/install-k6/troubleshooting/. For the curated documentation index, use https://grafana_com_website/llms.txt. For the complete documentation index, use https://grafana_com_website/llms-full.txt.

This is documentation for the next version of Grafana k6 documentation. For the latest stable release, go to the latest version.

Grafana k6

Set up

Install k6

Troubleshooting

Open source

Troubleshooting

System lacks ca-certificates or gnupg2

Some Linux distributions don’t come bundled with the ca-certificates and gnupg2 packages. If you use such a distribution, you’ll need to install them with:

sudo apt-get update && sudo apt-get install -y ca-certificates gnupg2

This example is for Debian/Ubuntu and derivatives. Consult your distribution’s documentation if you use another one.

Behind a firewall or proxy

Some users have reported that they can’t download the key from Ubuntu’s keyserver. When they run the gpg command, their firewalls or proxies block their requests to download. If this issue affects you, you can try this alternative:

curl -s https://dl.k6.io/key.gpg | gpg --dearmor | sudo tee /usr/share/keyrings/k6-archive-keyring.gpg

Old rpm-based Linux distributions

Distributions like Amazon Linux 2 and CentOS before version 8 don’t support the PGP V4 signature we use. You’ll need to disable the verification when you install k6: