Docs Home → Atlas App Services
appservices apps create
On this page
Realm is now Atlas Device SDK – Learn More
Create a new app (or a template app) from your current working directory and deploy it to the 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
Command Syntax
appservices 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 |
--provider-region | string | false | Select the app's provider region [Learn more: https://www.mongodb.com/docs/atlas/app-services/manage-apps/deploy/deployment-models-and-regions/#cloud-deployment-regions] |
-d, --deployment-model | string | false | Select the app's deployment model (Default value: <none>; Allowed values: GLOBAL, LOCAL) [Learn more: https://www.mongodb.com/docs/atlas/app-services/manage-apps/deploy/deployment-models-and-regions/#deployment-models] |
-e, --environment | string | false | Select the app's environment (Default value: <none>; Allowed values: development, testing, qa, production) [Learn more: https://www.mongodb.com/docs/atlas/app-services/manage-apps/configure/environments/] |
--cluster | strings | false | Link Atlas cluster(s) to your app (Note: Only one cluster can be linked during app creation if creating a template app) |
--cluster-service-name | strings | false | Specify the app's Service name to reference your Atlas cluster (Note: Service names will be overwritten when creating a template app) |
--serverless-instance | strings | false | Link Atlas Serverless instance(s) to your app (Note: Serverless instances cannot be used to create template apps) |
--serverless-instance-service-name | strings | false | Specify the app's Service name to reference your Atlas Serverless instance |
--federated-database | strings | false | Link Atlas Federated Database instance(s) to your app (Note: Federated Database instances cannot be used to create template apps) |
--federated-database-service-name | strings | false | Specify the app's Service name to reference your Atlas Federated Database instance |
--template | string | false | Create your app from an available template [Learn more: https://www.mongodb.com/docs/atlas/app-services/reference/template-apps/#template-apps-available] |
-x, --dry-run | false | Run without writing any changes to the local filepath or pushing any changes to the App Services server | |
--project | string | false | Specify the ID of a MongoDB Atlas project |
-h, --help | false | help for create |
Inherited Options
Name | Type | Required | Description |
|---|---|---|---|
--profile | string | false | Specify your profile (Default value: "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 |