Linux

This guide will help you install Pyroscope Agent on Linux.

Install#

Pyroscope team maintain and sign packages for the following Linux distributions:

Download package:
wget https://dl.pyroscope.io/release/pyroscope_0.2.2_amd64.deb

Install with apt-get:
sudo apt-get install ./pyroscope_0.2.2_amd64.deb
tip

To find out about other ways of installing Pyroscope, or to find packages for other CPU architectures (e.g ARM) visit our Downloads page.

Pyroscope Agent is not installed as systemd service. If you need to profile a process which is running as a service, you may wrap ExecStart option of the systemd unit with pyroscope exec.

Verify the installation#

To verify Pyroscope Agent was installed correctly, try the pyroscope command:

pyroscope

You should see output, similar to the following:

 _ __  _   _ _ __ ___  ___  ___ ___  _ __   ___| '_ \| | | | '__/ _ \/ __|/ __/ _ \| '_ \ / _ \| |_) | |_| | | | (_) \__ \ (_| (_) | |_) |  __/| .__/ \__, |_|  \___/|___/\___\___/| .__/ \___|| |     __/ |                       | ||_|    |___/                        |_|
continuous profiling platform
USAGE  pyroscope [flags] <subcommand>
SUBCOMMANDS  server   starts pyroscope server. This is the database + web-based user interface  exec     starts a new process from <args> and profiles it  connect  connects to an existing process and profiles it
FLAGS        DEFAULT VALUES
  -version  false
Run 'pyroscope SUBCOMMAND --help' for more information on a subcommand.

Next steps#

Refer to Configuration and Integrations pages to learn more about Pyroscop Agent and how to configure it.