--- title: Deployments description: Viewing and tracking deployments. url: https://docs.honeybadger.io/guides/deployments/ --- Deployment tracking lets you record when your app is deployed, see a history of deployments, and correlate code changes with errors. When you deploy, Honeybadger can automatically resolve open errors and notify your team. ## The Deployments page Your most recent deployments are listed on your project’s Deployments page, sorted by timestamp with the newest first. You can also filter by environment and adjust the time range, with presets for month to date, the last seven days, and yesterday. For each deployment, Honeybadger displays the timestamp, environment, deploying user, and revision. When GitHub or GitLab is connected, Honeybadger links the revision to a comparison page that shows a diff of what changed since the last deploy. ![Deployment screen showing recent deployments](https://docs.honeybadger.io/_astro/deployments.dFc7SaWN_Z25hpEV.webp) If your app is on Heroku, the user field shows which Heroku component triggered the deployment. ## Auto-resolving errors on deploy By default, all [unresolved errors](https://docs.honeybadger.io/guides/errors/#resolve--unresolve) are automatically marked as resolved when a deployment is recorded, which helps keep your [error list](https://docs.honeybadger.io/guides/errors/#browsing-errors) clean. If a resolved error re-occurs after a deploy, you will receive a new notification to let you know the error is still happening. Auto-resolving assumes you fix errors between deploys (or at least want to be reminded about errors frequently). To disable auto-resolve, uncheck *Resolve errors on deploy* in your [project’s settings](https://docs.honeybadger.io/guides/projects/#resolve-errors-on-deploy). When disabled, you can still [mark individual errors to resolve on the next deploy](https://docs.honeybadger.io/guides/errors/#resolve-on-deploy) on the error page. ## Searching with deployments Honeybadger’s [error search](https://docs.honeybadger.io/guides/errors/search/) supports several deployment-related tokens: | Token | Description | | ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | | `occurred.after:'last deploy'` | Errors that occurred since the most recent deployment | | `revision:"v1.0"` | Errors that occurred from a deployment with this revision | | `is:pending_resolution` | Errors set to resolve on the next deploy (when [auto-resolve](https://docs.honeybadger.io/guides/deployments/#auto-resolving-errors-on-deploy) is disabled) | The `occurred.after:'last deploy'` token is useful for spotting errors in new code, especially when combined with [environment or assignee filters](https://docs.honeybadger.io/guides/errors/search/#examples). ## Reporting deployments To track your deployments, you’ll need to notify Honeybadger each time you deploy. There are several ways to do this depending on your stack: ### Client libraries We have language-specific deployment tracking guides for [Ruby](https://docs.honeybadger.io/lib/ruby/errors/tracking-deployments/), [JavaScript](https://docs.honeybadger.io/lib/javascript/errors/tracking-deploys/), [PHP](https://docs.honeybadger.io/lib/php/errors/tracking-deploys/), [Python](https://docs.honeybadger.io/lib/python/errors/tracking-deployments/), and [Elixir](https://docs.honeybadger.io/lib/elixir/errors/tracking-deployments/). ### CI/CD and platform integrations * **GitHub Actions**: Use the [Honeybadger Deploy Action](https://github.com/marketplace/actions/honeybadger-deploy-action) * **Heroku**: See the [Heroku guide](https://docs.honeybadger.io/guides/heroku/#heroku-deployment-tracking) * **Netlify**: See the [JavaScript guide](https://docs.honeybadger.io/lib/javascript/errors/tracking-deploys/#from-netlify) * **Laravel Forge**: See the [PHP guide](https://docs.honeybadger.io/lib/php/errors/tracking-deploys/#tracking-deploys-from-laravel-forge) * **DeployHQ**: [Native Honeybadger integration](https://www.deployhq.com/support/integrations/honeybadger) ### Direct API For any other tool or pipeline, make a request directly to the Honeybadger API. See the [API reference](https://docs.honeybadger.io/api/reporting-deployments/) for a full list of parameters. ```sh HONEYBADGER_ENV="production" \ HONEYBADGER_REVISION="$(git rev-parse HEAD)" \ HONEYBADGER_REPOSITORY="$(git config --get remote.origin.url)" \ HONEYBADGER_API_KEY="Your project API key" \ && curl -g "https://api.honeybadger.io/v1/deploys?deploy[environment]=$HONEYBADGER_ENV&deploy[local_username]=$USER&deploy[revision]=$HONEYBADGER_REVISION&deploy[repository]=$HONEYBADGER_REPOSITORY&api_key=$HONEYBADGER_API_KEY" ``` If you are using our [EU stack](https://docs.honeybadger.io/resources/data-residency/), use `eu-api.honeybadger.io` instead of `api.honeybadger.io`. ### Honeybadger CLI Use the `hb deploy` command in the [Honeybadger CLI](https://docs.honeybadger.io/resources/cli/): ```shell hb deploy --environment production --repository github.com/org/repo --revision abc123 --user johndoe ``` ## Deployment notifications Honeybadger can notify your team when your app is deployed. Any of your configured [integrations](https://docs.honeybadger.io/guides/integrations/) — Slack, PagerDuty, email, and more — can be set up to receive deploy notifications. If you’re using the webhook integration, see the [deployed event payload](https://docs.honeybadger.io/guides/integrations/payloads/deployed/) for the payload format. --- ## Try Honeybadger for FREE Intelligent logging, error tracking, and Just Enough APM™ in one dev-friendly platform. Find and fix problems before users notice. [Start free trial](https://app.honeybadger.io/users/sign_up) [See plans and pricing](https://www.honeybadger.io/plans/)