MongoDB Atlas Management from CLI

Beginner12 minTrending

Manage MongoDB Atlas clusters, databases, and users from the command line using the Atlas CLI for automated cloud database operations.

Prerequisites

-MongoDB Atlas account (free tier available)
-Atlas CLI installed (brew install mongodb-atlas-cli or equivalent)

Steps

Authenticate with Atlas

$ atlas auth login

This opens a browser for OAuth authentication. For CI/CD, use API keys: atlas config init --apiKey and --privateKey.

List your Atlas projects

View all projects (organizations) in your Atlas account.

$ atlas projects list

Create a free-tier cluster

Deploy a new M0 (free tier) cluster in your project.

$ atlas clusters create dev-cluster --provider AWS --region US_EAST_1 --tier M0

M0 is free forever with 512MB storage. Use M10+ for production workloads.

Check cluster status

View the status and connection details of your clusters.

$ atlas clusters describe dev-cluster

Create a database user

Add a user with readWrite access for application connections.

$ atlas dbusers create --username app_user --password secure_pass --role readWriteAnyDatabase --projectId <project-id>

Get the connection string

Retrieve the connection string to use in your application.

$ atlas clusters connectionStrings describe dev-cluster

Use the 'mongodb+srv://' connection string format. It handles DNS-based service discovery and replica set routing automatically.

Full Script

full-script.sh

#!/bin/bash
# MongoDB Atlas CLI Management
set -euo pipefail

echo "=== Atlas Projects ==="
atlas projects list --output json | mongosh --nodb --quiet --eval "
const projects = JSON.parse(cat());
projects.results.forEach(p => {
  print(p.id + ': ' + p.name + ' (org: ' + p.orgId + ')');
});
" 2>/dev/null || atlas projects list

echo ""
echo "=== Clusters ==="
atlas clusters list --output json | mongosh --nodb --quiet --eval "
const clusters = JSON.parse(cat());
clusters.results.forEach(c => {
  print(c.name + ': ' + c.stateName + ' | ' + c.providerSettings.providerName +
    ' ' + c.providerSettings.regionName + ' | tier: ' + c.providerSettings.instanceSizeName);
});
" 2>/dev/null || atlas clusters list

echo ""
echo "=== Database Users ==="
atlas dbusers list

echo ""
echo "=== IP Access List ==="
atlas accessLists list

echo ""
echo "=== Connection Strings ==="
for CLUSTER in $(atlas clusters list --output json 2>/dev/null | mongosh --nodb --quiet --eval "JSON.parse(cat()).results.forEach(c => print(c.name))" 2>/dev/null || atlas clusters list --output go-template='{{range .results}}{{.name}}{{"
"}}{{end}}'); do
  echo "--- $CLUSTER ---"
  atlas clusters connectionStrings describe "$CLUSTER" 2>/dev/null || echo "  (unable to fetch)"
done

FAQ

Discussion

Loading comments...

#!/bin/bash # MongoDB Atlas CLI Management set -euo pipefail echo "=== Atlas Projects ===" atlas projects list --output json | mongosh --nodb --quiet --eval " const projects = JSON.parse(cat()); projects.results.forEach(p => { print(p.id + ': ' + p.name + ' (org: ' + p.orgId + ')'); }); " 2>/dev/null || atlas projects list echo "" echo "=== Clusters ===" atlas clusters list --output json | mongosh --nodb --quiet --eval " const clusters = JSON.parse(cat()); clusters.results.forEach(c => { print(c.name + ': ' + c.stateName + ' | ' + c.providerSettings.providerName + ' ' + c.providerSettings.regionName + ' | tier: ' + c.providerSettings.instanceSizeName); }); " 2>/dev/null || atlas clusters list echo "" echo "=== Database Users ===" atlas dbusers list echo "" echo "=== IP Access List ===" atlas accessLists list echo "" echo "=== Connection Strings ===" for CLUSTER in $(atlas clusters list --output json 2>/dev/null | mongosh --nodb --quiet --eval "JSON.parse(cat()).results.forEach(c => print(c.name))" 2>/dev/null || atlas clusters list --output go-template='{{range .results}}{{.name}}{{" "}}{{end}}'); do echo "--- $CLUSTER ---" atlas clusters connectionStrings describe "$CLUSTER" 2>/dev/null || echo " (unable to fetch)" done