Docs Menu

Roll Back Deployments

On this page

  • Overview
  • Procedure
  • View Your App's Deployment History
  • Re-Deploy a Prior Deployment
  • Confirm Rollback Success
  • Summary

When you view your deployment history, you'll see the 25 most recent deployments. You can use the Re-Deploy button to roll back to one of the last 25 deployments.

1

In order to roll back to a prior deploy, you'll need to navigate to your Realm app Deployment History page.

Click Deployment in the left navigation menu of the Realm UI. Select the History tab.

You'll see the 25 most recent application deployments. The Change Origin column shows whether the deploy originated from changes in the UI, the linked GitHub repository, the Admin API, or the CLI.

Deployment History screen with Realm, Deployment, and History tabs circled
2

Selecte a prior version to roll back to and then press the Re-Deploy button for that version of your Realm app.

If you have deployment drafts enabled, you'll see a modal notifying you that this action will replace any changes in your current deployment draft with the app configuration you want to re-deploy. Press the Re-Deploy button to confirm.

You'll see the banner at the top of your Realm app notifying you that you have changes to deploy. Press the Review Draft & Deploy button.

Next, you'll see a Deployment Draft that shows you a diff of the changes you'll apply when you complete this deploy. From here, you can specify a descriptive name for your deploy that will be visible in the Deployment History list.

If you have GitHub deployment enabled, you'll see a Deploy and Push to GitHub button. Push this button to confirm the rollback.

Screenshot of deployment draft with a Deploy and Push to GitHub button
3

After the deployment completes, you'll see the deployment success banner. The new deployment appears in your Deployment History.

If you have GitHub deployment enabled, it also contains a link to the commit in the GitHub repository.

In the linked GitHub repository, the commit author is the mongodb-realm bot.

Screenshot of deployment changes in GitHub
  • MongoDB Realm keeps track of your Deployment History. You can roll back to the last 25 deployments.
Give Feedback
© 2021 MongoDB, Inc.

About

  • Careers
  • Legal Notices
  • Privacy Notices
  • Security Information
  • Trust Center
© 2021 MongoDB, Inc.