Skip to main content

Quick Start

The easiest way to start with Parca is to obtain the pre-built statically-linked binary or the container. You can download the latest release of the binary from the Parca GitHub release pages (Server and Agent). Alternatively, you can use the Parca container image from the GitHub Container Registry.

Once you have the binary or the container, you can start profiling your applications with Parca.

Please select your environment and use the following commands to quickly get started

Server

  1. Download the binary specific to your OS and architecture

    curl -sL https://github.com/parca-dev/parca/releases/download/v0.19.0/parca_0.19.0_`uname -s`_`uname -m`.tar.gz | tar xvfz -

  2. Run Parca and access the Web UI on port 7070

    # Get basic configuration
    curl -sL https://raw.githubusercontent.com/parca-dev/parca/main/parca.yaml > parca.yaml
    # Run Parca and access the Web UI on port 7070
    ./parca --config-path=parca.yaml

Agent

  1. Download the binary specific to your architecture (only works on Linux)

    curl -sL https://github.com/parca-dev/parca-agent/releases/download/v0.25.0/parca-agent_0.25.0_`uname -s`_`uname -m`.tar.gz | tar xvfz -

  2. Run Parca Agent and access the Web UI on port 7071 (assumes Parca is running on localhost:7070)

    ./parca-agent --node=test --remote-store-address=localhost:7070 --remote-store-insecure

Parca from Binary - Tutorial 5min ⏱️