Airgapped upgrade guide

Upgrade your airgapped BugSnag On-premise clustered installation.

If you have the Single Machine version of BugSnag On-premise, please follow the single machine upgrade guide instead.

Upgrading your instance

If you are upgrading BugSnag On-premise on an online cluster, please follow the online upgrade guide.

Upgrading BugSnag will take approximately 15 minutes. During the upgrade there should not be any downtime if you have enabled high availability features.

Before upgrading, ensure you have backups of your current installation. See Backup & Restore guide for more information.

It is not necessary to upgrade notifier libraries used by your applications when upgrading BugSnag On-premise, although sometimes new features will require upgrading notifiers.

Download BugSnag airgap package

BugSnag will have provided you with a URL to download the offline installation package. You should download this and ensure the filename ends in .airgap.

curl -sSL -o bugsnag.airgap "<URL provided>"

Access the Replicated admin console

Run the following:

kubectl kots admin-console -n bugsnag

The Replicated admin console will be available at http://localhost:8800.

Press the ‘Upload new version’ button.


This will begin uploading the airgapped package to the admin console and will add the new release to the version section. Press the 'Deploy’ button next to the new version to start upgrading your installation.


Once the upgrade has completed the admin console will indicate that it is Started.


For more information about the updates see