Setting Up the Environment and Mongosh: Complete Configuration of a MongoDB Development Environment

# 1. Installation Docker Desktop for Mac (Apple Silicon)
# Download from https://www.docker.com/products/docker-desktop/

# 2. Pull MongoDB image
docker pull mongo:7.0

# 3. Start MongoDB Container(Port Forwarding + Data Volume)
docker run -d \
  --name mongodb-dev \
  -p 27017:27017 \
  -v ~/mongodb-data:/data/db \
  mongo:7.0

# 4. Use mongosh to connect
mongosh "mongodb://localhost:27017/admin"

# 5. Test Connection
db.runCommand({ ping: 1 })
# { ok: 1 }

# Inspection mongosh Version
mongosh --version
# mongosh 2.1.0

# Inspection mongod Server Version
mongod --version
# db version v7.0.5

# Through mongosh Check the server version
mongosh "mongodb://localhost:27017" --eval "db.version()"
# 7.0.5

# Installation Docker Desktop
# macOS: Download https://www.docker.com/products/docker-desktop/
# Windows: Download + Enable WSL 2 Backend
# Linux: sudo apt install docker.io docker-compose

# Verification Docker Installation
docker --version
# Docker version 24.0.7, build afdd53b

# Get the latest stable version
docker pull mongo:7.0

# Pull a specific version(Recommendations)
docker pull mongo:7.0.5

# Pull an image with authentication(Recommended Production Environments)
docker pull mongo:7.0-auth

# Standalone Development Mode(Not certified)
docker run -d \
  --name mongodb-dev \
  -p 27017:27017 \
  -v ~/mongodb-data:/data/db \
  --restart unless-stopped \
  mongo:7.0

# Certified Production Model
docker run -d \
  --name mongodb-prod \
  -p 27017:27017 \
  -v ~/mongodb-data:/data/db \
  -e MONGO_INITDB_ROOT_USERNAME=admin \
  -e MONGO_INITDB_ROOT_PASSWORD=YourSecurePass123 \
  --restart unless-stopped \
  mongo:7.0

# Verify the container's running status
docker ps
# CONTAINER ID   IMAGE      STATUS         PORTS
# a1b2c3d4e5f6   mongo:7.0  Up 2 minutes   0.0.0.0:27017->27017/tcp

# Use mongosh to connect
mongosh "mongodb://localhost:27017"

# In mongosh
db.runCommand({ ping: 1 })
# { ok: 1 }

# View container logs
docker logs mongodb-dev

# Stop the container
docker stop mongodb-dev

# Start the container
docker start mongodb-dev

# Restart the container
docker restart mongodb-dev

# Enter the container
docker exec -it mongodb-dev mongosh

# Delete Container(Data Volume Retention)
docker rm mongodb-dev

# Delete Containers and Data Volumes(Use with caution! Data Loss)
docker rm -v mongodb-dev

# Add MongoDB Official Tap
brew tap mongodb/brew

# Install the latest stable version
brew install mongodb-community@7.0

# Start MongoDB Services
brew services start mongodb-community@7.0

# Verification
mongosh --version
mongosh "mongodb://localhost:27017" --eval "db.runCommand({ ping: 1 })"

# Start mongod(Specify the data directory and log files)
mongod --dbpath ~/mongodb-data --logpath ~/mongodb.log --fork

# Verification
ps aux | grep mongod
# mongodb  12345  ... mongod --dbpath /Users/.../mongodb-data

# === 1. Installation Xcode Command Line Tools ===
xcode-select --install

# === 2. Installation Homebrew(If not yet) ===
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# === 3. Add MongoDB Tap ===
brew tap mongodb/brew

# === 4. Installation MongoDB ===
brew install mongodb-community@7.0

# === 5. Start the service ===
brew services start mongodb-community@7.0

# === 6. Connection Test ===
mongosh "mongodb://localhost:27017"

# === 7. The First Command ===
db.runCommand({ ping: 1 })
# { ok: 1 }

# 1. Import MongoDB GPG key
wget -qO - https://www.mongodb.org/static/pgp/server-7.0.asc | sudo apt-key add -

# 2. Add MongoDB repository
echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu jammy/mongodb-org/7.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-7.0.list

# 3. Update Package Index
sudo apt update

# 4. Installation MongoDB
sudo apt install -y mongodb-org

# 5. Start the service
sudo systemctl start mongod
sudo systemctl enable mongod

# 6. Verification
sudo systemctl status mongod
mongosh --eval "db.runCommand({ ping: 1 })"

# 1. Add MongoDB Yum repository
sudo tee /etc/yum.repos.d/mongodb-org-7.0.repo << 'EOF'
[mongodb-org-7.0]
name=MongoDB Repository
baseurl=https://repo.mongodb.org/yum/redhat/$releasever/mongodb-org/7.0/x86_64/
gpgcheck=1
enabled=1
gpgkey=https://www.mongodb.org/static/pgp/server-7.0.asc
EOF

# 2. Installation
sudo yum install -y mongodb-org

# 3. Start
sudo systemctl start mongod
sudo systemctl enable mongod

1. Visit https://www.mongodb.com/try/download/community
2. Select "Windows" + "msi" + Version 7.0
3. Download MongoDB-windows-x86_64-7.0.x-signed.msi
4. Double-click to install:
   ✅ Complete Installation Type
   ✅ Install MongoDB as a Service
   ✅ Install MongoDB Compass(GUI Tools)
5. After installation is complete，MongoDB Automatic Action Windows Service Start

# 1. Installation Chocolatey(If not yet)
Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))

# 2. Installation MongoDB
choco install mongodb

# 3. Start
mongod --dbpath C:\data\db

# 4. Connect
mongosh "mongodb://localhost:27017"

# === 1. Create a data directory ===
mkdir C:\data\db

# === 2. Start MongoDB ===
mongod --dbpath C:\data\db

# === 3. Connecting Another Device ===
mongosh "mongodb://localhost:27017"

# === 4. Test ===
db.runCommand({ ping: 1 })
# { ok: 1 }

1. Visit https://www.mongodb.com/cloud/atlas/register
2. Sign Up(Google / GitHub OAuth Fastest)
3. Select "Build a Cluster" → "Shared" → "M0 Sandbox"(Free)
4. Cloud Provider:AWS(Recommendations)
5. Region:
   - Users in the Middle East:me-central-1 (UAE)
   - Users in Brazil:sa-east-1 (São Paulo)
   - Japanese users:ap-northeast-1 (Tokyo)
6. Cluster Name:Cluster0
7. Click "Create Cluster"(Waiting 1-3 minutes)

Steps 1:Create a Database User
- Database Access → Add New Database User
- Username: alice
- Password: YourSecurePass123
- Database User Privileges: Read and write to any database

Steps 2:Configure the Network Whitelist
- Network Access → Add IP Address
- Select "Allow Access from Anywhere"(0.0.0.0/0)
  ⚠️ For development use only，The production environment should be limited to application servers. IP

1. Database → Connect → Connect your application
2. Driver: Node.js
3. Version: 5.5 or later
4. Concatenate Strings:
   mongodb+srv://alice:YourSecurePass123@cluster0.mongodb.net/mydb?retryWrites=true&w=majority

# Use mongosh to connect Atlas
mongosh "mongodb+srv://cluster0.mongodb.net/mydb" --username alice
# Password: ****

# In mongosh
db.runCommand({ ping: 1 })
# { ok: 1 }

# Insert the first document
db.users.insertOne({ name: "Alice", email: "alice@example.com" })

# Search
db.users.find()
# { _id: ObjectId('...'), name: 'Alice', email: 'alice@example.com' }

# Connect to the default local port
mongosh

# Connect to a specified host and port
mongosh "mongodb://localhost:27017"

# Connect Atlas
mongosh "mongodb+srv://cluster0.mongodb.net/mydb" --username alice

# Connect and execute a single command
mongosh "mongodb://localhost:27017" --eval "db.runCommand({ ping: 1 })"

# Enable verbose Pattern(View the time taken by each command)
mongosh --verbose

// === Database Operations ===
show dbs                    // List all databases
use shopdb                  // Switch to shopdb Database(If it doesn't exist, create it implicitly)
db                          // Display the current database
db.dropDatabase()           // Delete the current database

// === Set Operations ===
show collections            // List all collections in the current database
db.createCollection("products")  // Explicitly Creating Sets
db.products.drop()          // Delete Set

// === Document Operations ===
db.products.insertOne({ sku: "PHONE-001", price: 599.99 })
db.products.find()          // Search All Documents
db.products.find().pretty() // Formatted Output
db.products.countDocuments()  // Count the number of documents

// === Help Command ===
help                        // mongosh Built-in Help
db.help()                   // Database Command Help
db.products.help()          // Set Operations Help

# === Writing Scripts(setup-mongosh.js) ===
cat > setup-mongosh.js << 'EOF'
// Switch to shopdb
use shopdb;

// Create a User Set
db.users.insertMany([
  { name: "Alice", email: "alice@example.com", age: 28 },
  { name: "Bob", email: "bob@example.com", age: 32 },
  { name: "Charlie", email: "charlie@example.com", age: 25 }
]);

// Create a Product Collection
db.products.insertMany([
  { sku: "PHONE-001", title: "Phone X", price: 599.99, stock: 50 },
  { sku: "LAPTOP-001", title: "Laptop Y", price: 1299.99, stock: 20 }
]);

// Search All Users
print("Users:");
db.users.find().forEach(printjson);

// Search All Products
print("Products:");
db.products.find().forEach(printjson);
EOF

# === Run the script ===
mongosh "mongodb://localhost:27017" setup-mongosh.js

1. Open VSCode
2. Extensions (Ctrl+Shift+X)
3. Search "MongoDB for VS Code"
4. Click Install(Official Plug-in，provided by MongoDB Inc.)

1. Click the sidebar MongoDB Icon
2. Click "Add Connection"
3. Enter the connection string:
   - Local:mongodb://localhost:27017
   - Atlas:mongodb+srv://cluster0.mongodb.net/mydb
4. Enter your username and password
5. Select a Database，Browse Collections

- Right-Click Menu → "View Documents":Browsing Data
- Right-Click Menu → "Insert Document":Insert Document
- Right-click the document → "Edit Document":Edit
- Right-click the document → "Delete Document":Delete
- Top Toolbar → "Playgrounds":Run mongosh Screenplay

// VSCode MongoDB Playground
use('shopdb');

db.users.aggregate([
  { $group: { _id: '$age', count: { $sum: 1 } } },
  { $sort: { _id: 1 } }
]);

// In mongosh
db.runCommand({ ping: 1 });

// Output:
// { ok: 1 }

// Timestamped ping
const start = Date.now();
const result = db.runCommand({ ping: 1 });
const duration = Date.now() - start;
print(`Ping successful in ${duration}ms`);
printjson(result);

// ping-test.js
const { MongoClient } = require('mongodb');

async function testConnection() {
  const client = new MongoClient('mongodb://localhost:27017');

  try {
    const start = Date.now();
    await client.connect();

    const result = await client.db('admin').command({ ping: 1 });
    const duration = Date.now() - start;

    console.log(`✅ Connected in ${duration}ms`);
    console.log('Ping result:', result);

    if (result.ok === 1) {
      console.log('🎉 MongoDB connection is healthy!');
    } else {
      console.error('❌ Ping failed:', result);
    }
  } catch (err) {
    console.error('❌ Connection error:', err.message);
    process.exit(1);
  } finally {
    await client.close();
  }
}

testConnection();

// health-check.js
const { MongoClient } = require('mongodb');
const mongoose = require('mongoose');

async function healthCheck() {
  const results = {
    native_driver: false,
    mongoose: false,
    timestamp: new Date().toISOString()
  };

  // 1. Testing Native Drivers
  try {
    const client = new MongoClient('mongodb://localhost:27017');
    await client.connect();
    const ping = await client.db('admin').command({ ping: 1 });
    results.native_driver = ping.ok === 1;
    await client.close();
    console.log('✅ Native driver ping:', ping.ok === 1);
  } catch (err) {
    console.error('❌ Native driver ping failed:', err.message);
  }

  // 2. Test mongoose
  try {
    await mongoose.connect('mongodb://localhost:27017/test');
    const adminDb = mongoose.connection.db.admin();
    const ping = await adminDb.command({ ping: 1 });
    results.mongoose = ping.ok === 1;
    await mongoose.disconnect();
    console.log('✅ Mongoose ping:', ping.ok === 1);
  } catch (err) {
    console.error('❌ Mongoose ping failed:', err.message);
  }

  console.log('\nHealth check results:', JSON.stringify(results, null, 2));
  return results;
}

healthCheck();

# Check the container logs to find the cause
docker logs mongodb-dev

# Common Mistakes:Port is in use
# Error: bind: address already in use

# Solutions 1:Processes that are occupying ports
lsof -i :27017
kill -9 <PID>

# Solutions 2:Switch to a different port
docker run -d --name mongodb-dev -p 27018:27017 mongo:7.0
mongosh "mongodb://localhost:27018"

# Check Disk Space
df -h

# MongoDB Default disk space used by the data directory
du -sh ~/mongodb-data

# Cleanup Plan:Settings oplogSize Restrictions(Raid Mode)
mongod --oplogSize 1024

# or use WiredTiger Compression(Enabled by default)
mongod --wiredTigerCollectionConfig blockCompressor=zstd

# === Steps 1:Inspection mongod Is it running? ===
ps aux | grep mongod | grep -v grep

# === Steps 2:Check Port Listening ===
lsof -iTCP:27017 -sTCP:LISTEN

# === Steps 3:Try connecting ===
mongosh "mongodb://localhost:27017"

# === Steps 4:View mongod Log ===
tail -50 /usr/local/var/log/mongodb/mongo.log

# === Steps 5:Restart the service ===
brew services restart mongodb-community@7.0

# === Steps 6:Test Again ===
mongosh "mongodb://localhost:27017" --eval "db.runCommand({ ping: 1 })"