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.0.39_amd64.deb

Install with apt-get:
sudo apt-get install ./pyroscope_0.0.39_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.