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:
To start using Blackfire, we are going to install the following:
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 dd of=/usr/share/keyrings/blackfire-archive-keyring.asc
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/blackfire-archive-keyring.asc] http://packages.blackfire.io/debian any main" | sudo tee /etc/apt/sources.list.d/blackfire.list
sudo apt update
sudo apt install blackfire
This command asks for some Blackfire server credentials, log in or sign up now to get them:
or Sign UpLearn more about the agent configuration file.
sudo systemctl restart blackfire-agent
During the agent installation, a new
blackfire-agent service was created to
start, stop, and restart it. Whenever you modify the agent
configuration, restart it.
/var/log/blackfire/agent.log. Change the log file or the log level in the agent configuration file.
sudo apt install blackfire-php
PHP will likely crash when Blackfire is used when one of the following
extensions is also enabled:
XDebug is installed, the PHP engine may not behave as
expected; consider disabling it when profiling.
pcov extension is installed, Blackfire will not
behave as expected; consider disabling it when profiling.
You can now enable monitoring for your environments.
To profile applications, you need to use a profiling client:
Profile from a browser via our browser extensions (Web applications only).
Profile from the command line via the
(Web applications, APIs, command line tools, daemons, and more).
Configure it with your personal credentials:
blackfire client:config --client-id=CLIENT_ID --client-token=CLIENT_TOKEN
Start profiling via: