Docs Menu
Docs Home
/ /
Atlas App Services
/ / / /

realm-cli apps create

On this page

  • Syntax
  • Options
  • Inherited Options

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".

realm-cli apps create [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
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
← apps
delete →