realm-cli apps create
On this page
Important
Realm CLI is Deprecated
realm-cli is deprecated and will not receive future features or
bug fixes. Instead, use the App Services CLI.
App Services CLI is available on npm. To install the CLI on your system,
ensure that you have Node.js
installed and then run the following command in your shell:
npm install -g atlas-app-services-cli
Create a new app from your current working directory and deploy it to the Atlas App Services server
Creates a new App by saving your configuration files in a local directory and deploying the new app to the App Services server. This command will create a new directory for your project.
You can specify a "--remote" flag to create an App from an existing app; if you do not specify a "--remote" flag, the CLI will create a default App.
NOTE: To create an App without deploying it, use "app init".
Syntax
realm-cli apps create [options]
Options
Name | Type | Required | Description |
|---|---|---|---|
--remote | string | false | Specify the name or ID of a remote App to clone |
--local | string | false | Specify the local filepath of an App to be created |
-n, --name | string | false | Name your new App |
-l, --location | String | false | Select the App's location (Default value: <none>; Allowed values: US-VA, US-OR, DE-FF, IE, AU, IN-MB, SG) |
-d, --deployment-model | String | false | Select the App's deployment model (Default value: <none>; Allowed values: GLOBAL, LOCAL) |
-e, --environment | String | false | Select the App's environment (Default value: <none>; Allowed values: development, testing, qa, production) |
--cluster | strings | false | Link Atlas clusters to your App |
--cluster-service-name | strings | false | Specify the App Service name to reference your Atlas cluster |
--datalake | strings | false | Link Federated database instances to your App |
--datalake-service-name | strings | false | Specify the App Service name to reference your Federated database instance |
--template | string | false | Create your App from an available template |
-x, --dry-run | false | Run without writing any changes to the local filepath or pushing any changes to the App Services server | |
-h, --help | false | help for create |
Inherited Options
Name | Type | Required | Description |
|---|---|---|---|
--profile | string | false | Specify your profile (Default value: "default") (default "default") |
--telemetry | String | false | Enable/Disable CLI usage tracking for your current profile (Default value: "on"; Allowed values: "on", "off") |
-o, --output-target | string | false | Write CLI output to the specified filepath |
-f, --output-format | String | false | Set the CLI output format (Default value: <blank>; Allowed values: <blank>, "json") |
--disable-colors | false | Disable all CLI output styling (e.g. colors, font styles, etc.) | |
-y, --yes | false | Automatically proceed through CLI commands by agreeing to any required user prompts |