Docs Menu
Docs Home
/ /

atlas local setup

Create a local deployment.

To learn more about local atlas deployments, see https://www.mongodb.com/docs/atlas/cli/current/atlas-cli-deploy-local/

Command Syntax
atlas local setup [deployment_name] [options]
Name
Type
Required
Description

deployment_name

string

false

Name of the deployment that you want to set up

Name
Type
Required
Description

-h, --help

false

help for setup

--bindIpAll

false

Flag that indicates whether the LOCAL deployment port binding should happen for all IPs or only for the localhost interface 127.0.0.1.

The default is false.

--connectWith

string

false

Method for connecting to the deployment after setup.

If not provided, the user will be prompted to select a connection method.

--force

false

Flag that indicates whether to skip the confirmation prompt before proceeding with the requested action.

The default is false.

--image

string

false

Alternative docker image to use for the deployment.

The default is the official MongoDB Atlas Local image. To learn more about the official MongoDB Atlas Local image, see https://hub.docker.com/r/mongodb/mongodb-atlas-local

--initdb

string

false

Flag that uses a folder to be mapped into LOCAL deployment for initialization

The folder must exist and be a directory.

--loadSampleData

false

Flag that indicates whether to load sample data into the deployment.

The default is false.

--mdbVersion

string

false

MongoDB version to use for the deployment.

Expected format: <major>[.<minor>[.<patch>]] or 'latest'. Some examples: 8, 8.2, 8.2.1, latest

--password

string

false

Password for the user

--port

int

false

Port that the MongoDB server listens to for client connections.

The port must be between 1 and 65535.

--skipPullImage

false

Flag that indicates whether to skip the pull image step.

This will prevent the CLI from pulling the latest MongoDB Atlas Local image. Use with caution as you might end up with an outdated image.

The default is false.

--username

string

false

Username for authenticating to MongoDB

Name
Type
Required
Description

-o, --output

string

false

Output format

-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

Back

list

On this page