Docs Menu

Deploy Changes with Realm CLI

On this page

  • Overview
  • Prerequisites
  • Procedure
  • Log In to MongoDB Cloud
  • Pull the Latest Version of Your App
  • Update Your Application
  • Deploy the Updated App

You can deploy changes to your Realm app with Realm CLI by importing an application directory with configuration files that define the updated app.

  • A MongoDB Atlas programmatic API Key.
  • A properly installed copy of realm-cli that has been added to your system PATH.

If you're using Automated GitHub Deploy, do not update your Realm app configuration via the Realm CLI. Instead, push your changes to the linked GitHub repository.


To configure your app with realm-cli, you must log in to MongoDB Cloud using an API key scoped to the organization or project that contains the app.

realm-cli login --api-key="<MongoDB Cloud Public API Key>" --private-api-key="<MongoDB Cloud Private API Key>"

You'll need a local copy of your application's configuration files. To pull a local copy of the latest version of your app, run the following:

realm-cli pull --remote="<Your App ID>"

You can also download a copy of your application's configuration files from the Deploy > Import/Export App screen in the Realm UI.


Add, delete, and modify configuration files for your application's various components.


Once you've updated your app's configuration files, you can push them to your remote app. Realm CLI immediately deploys the updated configurations on push.

realm-cli push --remote="<Your App ID>"
Give Feedback
© 2021 MongoDB, Inc.


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