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