Docs Menu
Docs Home
/ /
Atlas CLI
/ /

atlas projects create

On this page

  • Syntax
  • Arguments
  • Options
  • Inherited Options
  • Output
  • Examples

Create a project in your organization.

Projects group clusters into logical collections that support an application environment, workload, or both. Each project can have its own users, teams, security, and alert settings.

To use this command, you must authenticate with a user account or an API key with the Project Data Access Read/Write role.

Command Syntax
atlas projects create <projectName> [options]
Name
Type
Required
Description
projectName
string
true
Label that identifies the project.
Name
Type
Required
Description
--govCloudRegionsOnly
false
Flag that designates that the project uses only the AWS GovCloud region. Use this option only for Atlas for Government projects. If unspecified, the project uses only the AWS Standard region for AWS deployments. You can't deploy clusters across AWS GovCloud and AWS Standard regions in the same project.
-h, --help
false
help for create
--orgId
string
false
Organization ID to use. This option overrides the settings in the configuration file or environment variable.
-o, --output
string
false
Output format. Valid values are json, json-path, go-template, or go-template-file. To see the full output, use the -o json option.
--ownerId
string
false
Unique 24-digit string that identifies the Atlas user to be granted the Project Owner role on the specified project. If unspecified, this value defaults to the user ID of the oldest Organization Owner.
--tag
key=value
false
List that contains key-value pairs between 1 to 255 characters in length for tagging and categorizing the project.
--withoutDefaultAlertSettings
false
Flag that creates the new project without the default alert settings enabled. This flag defaults to false. This option is useful if you create projects programmatically and want to create your own alerts instead of using the default alert settings.
Name
Type
Required
Description
-P, --profile
string
false
Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings.

If the command succeeds, the CLI returns output similar to the following sample. Values in brackets represent your values.

Project '<Id>' created.
# Create a project in the organization with the ID 5e2211c17a3e5a48f5497de3 using default alert settings:
atlas projects create my-project --orgId 5e2211c17a3e5a48f5497de3 --output json

Back

list