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:
v2 version is the one you want to use. If you have
automation based on the previous version, select
v1, which is still
supported until the Aug, 31th 2021.
If you are upgrading from v1, please read the upgrade guide.
To start using Blackfire, we are going to install the following:
BLACKFIRE_CLIENT_ID="CLIENT_ID" \ BLACKFIRE_CLIENT_TOKEN="CLIENT_TOKEN" \ BLACKFIRE_SERVER_ID="SERVER_ID" \ BLACKFIRE_SERVER_TOKEN="SERVER_TOKEN" \ bash -c "$(curl -L https://installer.blackfire.io/installer.sh)"
This installs the APT package for the Blackfire Agent. It might prompt for your password to grant root privileges.
sudo apt install python-pip
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
for Python >= 3.0.
blackfire-python command is in your
pip package installs the
which can be used for zero configuration profiling.
The folder where
blackfire-python is installed may vary
depending on your Python environment (e.g.
Note that the folder
blackfire-python is installed in must be
If you previously installed Blackfire bootstrap configuration hook
blackfire_bootstrap.pth, in versions <=
you must uninstall it by running the following command:
python -m blackfire uninstall-bootstrap
You can now enable monitoring for your environments.
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).
Profile from the command line via the
(Web applications, APIs, command line tools, daemons, and more).
Start profiling via: