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

appservices apps create

On this page

  • Syntax
  • Options
  • Inherited Options

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

Command Syntax
appservices 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 (Note: This name will be used internally and cannot be changed later. Names must only include: ASCII letters, numbers, underscores ( _ ), or dashes ( - ))
--provider-region
string
false
Select the app's provider region [Learn more]
-d, --deployment-model
string
false
Select the app's deployment model (Default value: <none>; Allowed values: GLOBAL, LOCAL) [Learn more]
-e, --environment
string
false
Select the app's environment (Default value: <none>; Allowed values: development, testing, qa, production) [Learn more]
--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]
-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
Name
Type
Required
Description
--profile
string
false
Specify your profile (Default value: "default") [Learn more]
--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

Back

apps