Realm >
Node.js SDK >
Work with MongoDB Realm

Initialize the Realm App Client¶

Overview¶

The Realm app client is the interface to the MongoDB Realm backend. It provides access to the authentication functionality, functions, and sync management.

Access the App Client¶

Pass the MongoDB Realm App ID for your Realm app, which you can find in the Realm UI.

TypeScript
JavaScript

copy

const id = "<Your App ID>"; // replace this with your App ID

copy

const id = "<Your App ID>"; // replace this with your App ID

Configuration¶

To set up your Realm app client, pass a configuration object to an instance of Realm.App.

TypeScript
JavaScript

copy

const config = {
  id,
};
const app: Realm.App = new Realm.App(config);

copy

const config = {
  id,
};
const app = new Realm.App(config);

Note

id is a required field of the application configuration object. To see the full list of fields for the configuration object that Realm.App accepts as a parameter, view the App Configuration Type Definitions.

Retrieve an Instance of the App Client¶

To retrieve an instance of the App Client from anywhere in your application, call Realm.App.getApp() and pass in your App ID.

TypeScript
JavaScript

copy

const app: Realm.App =  Realm.App.getApp("<Your App ID>"); // replace this with your App ID

copy

const app = Realm.App.getApp("<Your App ID>"); // replace this with your App ID

← Encrypt a Realm Authenticate a User →