Installing Blackfire¶

Installing Blackfire

Installing and updating Blackfire should be a quick process. This document will guide you through the steps.

For a better experience, you should or Sign Up.

Tell us what you want to do:

I want to Blackfire

which uses

for the language.

To start using Blackfire, we are going to install the following:

A language extension;
An agent to communicate with Blackfire's servers;
A profiling client (a browser extension or a CLI tool).

Configure the Debian Repository ¶

Blackfire uses a custom Debian repository to distribute its packages; it is compatible with most Debian-based distributions like Ubuntu and Linux-Mint.

wget -q -O - https://packages.blackfire.io/gpg.key | sudo apt-key add -

Add the repository to Debian source list:

echo "deb http://packages.blackfire.io/debian any main" | sudo tee /etc/apt/sources.list.d/blackfire.list

Update the repositories:
```
sudo apt update
```

Install the Packages ¶

Install the blackfire-agent package:
```
sudo apt install blackfire-agent
```

Configure the Agent ¶
An agent has been detected An upgrade is available No agents have been detected

This command asks for some Blackfire server credentials, log in or sign up now to get them:

or Sign Up
Restart the agent service:
```
sudo /etc/init.d/blackfire-agent restart
```
During the agent installation, a new /etc/init.d/blackfire-agent service was created to start, stop, and restart it. Whenever you modify the agent configuration, restart it.
If something goes wrong, check out the log file generated by default in /var/log/blackfire/agent.log. Change the log file or the log level in the agent configuration file.

Install the Python Probe ¶

Install pip:
```
sudo apt install python-pip
```
Install the blackfire package:
```
pip install blackfire --user
```
If you have multiple versions of Python installed on your system, it is possible that you have multiple versions of the pip binary installed as well. For example, you can have pip2 installed for Python >= 2.0, and pip3 installed for Python >= 3.0.
In order to profile with blackfire run without any code modification on your application, you need to install the blackfire_bootstrap.pth file as a site-specific configuration hook:
```
python -m blackfire install-bootstrap
```
If you want to remove the blackfire_bootstrap.pth file, you can run this command:
```
python -m blackfire uninstall-bootstrap
```

Check that there are no errors in the logs. To debug problems, change the log level and the log file in the probe configuration.

Install a Profiling Client ¶
Chrome Extension Installed Chrome Extension Upgrade Available Chrome Extension Not Installed

To profile applications, use the Python SDK.

For on-demand profiling, you need to install a profiling client:

Profile from a browser via our browser extensions (Web applications only).

Your browser is not supported. Please switch to Firefox or Google Chrome to be able to profile from a browser.

You are currently using Google Chrome.

Install the Blackfire Extension from the Google Chrome Web Store:

Install the Extension

Congratulations! You can start profiling your applications from this browser as the Extension is already installed.

You are currently using Firefox.

Install the Blackfire extension from the Mozilla Add-On website:

Install the Extension
Profile from the command line via the blackfire tool (Web applications, APIs, command line tools, daemons, and more).

Configure it with your personal credentials:
```
blackfire config --client-id=CLIENT_ID --client-token=CLIENT_TOKEN
```

Start Profiling ¶

Start profiling via: