Updating Blackfire

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

Check out the blackfire doctor command if you need help troubleshooting your installation.

Loading...

For your information, here are the latest versions of each Blackfire component:

  Latest Version Installed Version
Unified Agent and Client v2 2026.3.0
Loading...
PHP Probe 1.92.60
Loading...
Chrome/Firefox Extension 2026.3.0

Update Packages

  1. Update the Debian repository:
    Loading...
  2. Update the blackfire package:
    Loading...
  3. Update the PHP Probe:
    Loading...

    If you installed the PHP Probe via the package manager, head to the step-by-step guide to upgrade.

Restart Services

  1. Restart the agent service:
    Loading...
  2. Restart your web server or PHP-FPM and check that there are no errors in the logs. To debug problems, you can change the log level and the log file in the Probe configuration.

Component Lifecycle

All Blackfire components have a 180-day decommissioning policy.
  • Probes: Expire based on two factors: the upstream runtime lifecycle and the release of newer Probe versions.
    You have 180 days to upgrade after a newer Probe is released, even if your runtime version is still supported.
  • Agent: Expires 180 days after a newer version is published
Maintain support and security by reviewing the Full Deprecation Policy.