Upgrade guide

Upgrade your Bugsnag Enterprise installation.

Usual upgrade process

Before upgrading, ensure you have backups of your current installation.

It is not necessary to upgrade notifier libraries used by your applications when upgrading Bugsnag Enterprise, although sometimes new features will require upgrading notifiers.

To upgrade an existing Bugsnag Enterprise 2.x installation, run the following command:

$ sudo bugsnag upgrade

Downloading and upgrading Bugsnag can take between 15-30 minutes. Bugsnag should remain available for this time.

Upgrading offline

See Installing bugsnag offline for prefetching an offline archive to upgrade. To upgrade on an offline machine, run the following command:

$ sudo bugsnag upgrade --offline=/path/to/bugsnag-offline-archive.tar.gz

Non interactive upgrading

See Non interactive install for more information about the parameters:

$ sudo bugsnag upgrade --accept-eula --license-file=/path/to/license_file

--accept-eula If you are required to accept a EULA as part of your upgrade, supplying this option will bypass the prompt. Using this option implies that you have read and agree to the terms of the EULA.

--license-file parameter needs the location to the license key file. Optional unless a new license is needed or no current license exists.

Upgrading Bugsnag Enterprise 1.x

To upgrade from Bugsnag Enterprise 1.x, follow these instructions.

1. Confirm Docker is up to date

Bugsnag Enterprise 2 requires at least version 1.10 of Docker and 1.7 of Docker Compose. You can confirm which versions are installed with these commands.

$ sudo docker version
$ sudo docker-compose version

2. Update your installation script

Download the bugsnag installation and management script and install it into your PATH.

$ curl -L -O https://www.bugsnag.com/enterprise-v2/bugsnag
$ chmod +x bugsnag
$ sudo mv bugsnag /usr/bin

3. Upgrade Bugsnag

Before upgrading, ensure you have backups of your current installation.

Run the following command to upgrade Bugsnag:

$ sudo bugsnag upgrade

Downloading and upgrading Bugsnag can take between 15-30 minutes. Your Bugsnag dashboard will not be available during the upgrade.