MongoDB Installation

What Is MongoDB Installation?

Installing MongoDB means setting up the MongoDB server so applications can store and retrieve data from a MongoDB database.

             MongoDB
                |
        +-------+-------+
        |       |       |
        v       v       v
      mongod  mongosh Compass
      Server    Shell    GUI (optional)

mongod is the server process. mongosh is the shell that connects to it. Compass is an optional GUI. Atlas is MongoDB’s managed cloud database—no local mongod required when you use Atlas alone.

MongoDB Installation Options

Pick the path that matches how you want to run MongoDB.

Compass does not install MongoDB Server. Atlas does not require a local mongod when you use the cloud deployment.

What Gets Installed?

Not every method installs every tool. Know the roles:

mongod   → MongoDB Server (stores + processes data)
mongosh  → Shell client (connect + run commands)
Compass  → Optional GUI client
Tools    → Optional utilities (import/export, etc.)

• MongoDB Server (mongod) — accepts connections and manages data.
• MongoDB Shell (mongosh) — interactive CLI for developers and admins.
• MongoDB Compass — optional graphical interface.
• Database Tools — optional utilities; some install methods include them.

On Windows MSI installs, mongosh is installed separately from the server. On macOS Homebrew Community installs, mongosh is typically included with the formula. Always confirm against the current official docs for your method.

How MongoDB Works After Installation

Your Application
       |
       v
 MongoDB Driver
       |
       v
     mongod
       |
       v
 MongoDB Database

mongosh
   |
   v
mongod
   |
   v
Database

Applications normally connect through a MongoDB driver. Developers use mongosh for interactive learning and admin tasks.

System Requirements

Requirements depend on operating system, MongoDB version, CPU architecture, and install method. MongoDB documents supported platforms per release—check the official installation page for your version before you install.

Examples from current Community docs (verify for your release): Windows Server 2022 and Windows 11 (x86_64); macOS 14+ on supported CPUs; specific Ubuntu LTS and RHEL/Rocky/AlmaLinux versions. MongoDB is not supported on Windows Subsystem for Linux (WSL).

Official Download & Installation Links

Use MongoDB’s current official pages for downloads and OS-specific steps. Package names and supported platforms can change between releases.

Install by Operating System

Choose your platform. Windows is shown first—switch tabs for macOS or Linux. Commands are OS-specific; do not mix them.

Download MongoDB MSI
      ↓
Install MongoDB Server
      ↓
Install mongosh separately
      ↓
Start MongoDB (service or manual)
      ↓
Connect with mongosh

mongosh

Install Xcode CLT + Homebrew
       ↓
brew tap mongodb/brew
       ↓
Install mongodb-community@<version>
       ↓
Start mongod
       ↓
Connect with mongosh

# Prerequisites (once)
xcode-select --install
# Then install Homebrew from https://brew.sh

brew tap mongodb/brew
brew trust mongodb/brew
brew update

# Example for current docs — replace 9.0 with your target version
brew install [email protected]

# Start / stop as a service
brew services start [email protected]
brew services stop [email protected]

Add official MongoDB repository
        ↓
Install mongodb-org packages
        ↓
Start mongod (systemd)
        ↓
Enable service (optional)
        ↓
Connect with mongosh

# After adding the official repo for your Ubuntu + MongoDB version:
sudo apt update
sudo apt install -y mongodb-org

# systemd (common on modern Ubuntu)
sudo systemctl start mongod
sudo systemctl status mongod
sudo systemctl enable mongod   # start on boot (optional)

Starting MongoDB

Service-based
    |
    v
OS manages mongod


Manual
    |
    v
You start mongod directly

Do not mix Windows, macOS, and Linux commands in one script. Installing MongoDB is different from starting it—the server must be running before clients connect.

Verify MongoDB Is Running

The simplest check: open the shell and ping the server.

mongosh

db.runCommand({ ping: 1 })

{ ok: 1 }

How It Works

1. mongosh attempts to connect to MongoDB (default local host/port).
2. db.runCommand({ ping: 1 }) sends a ping command to the server.
3. A response with ok: 1 means the connection is working.

First MongoDB Commands

After connect, try a tiny write/read cycle.

db
show dbs

db.test.insertOne({
  message: "MongoDB is working"
})

db.test.find()

How It Works

1. db shows the current database context.
2. show dbs lists databases visible to you.
3. insertOne() creates a document in the test collection.
4. find() reads the documents back—full write/read cycle complete.

MongoDB Installation Walkthrough

Install MongoDB
      ↓
Start MongoDB
      ↓
Open mongosh
      ↓
Run ping
      ↓
Create a document
      ↓
Read the document

Use the Install by Operating System tabs (Windows, macOS, or Linux), then run the verify and first-command steps above. Do not combine incompatible OS commands.

MongoDB Compass

MongoDB Compass is a graphical user interface for MongoDB. It is optional.

MongoDB Server (mongod / Atlas)
              ↑
              |
           Compass

MongoDB Server ≠ Compass

Use Compass to browse databases and collections, view or edit documents, and explore features your deployment allows. Installing Compass does not install the server. Download it from the official Compass download page. Learn more on a dedicated Compass page when available.

MongoDB Atlas

MongoDB Atlas is MongoDB’s managed cloud database service. See the official Atlas documentation or create an Atlas account.

Local MongoDB

Your Computer
     |
     v
   mongod
     |
     v
Database


MongoDB Atlas

Your Application
     |
     v
Internet
     |
     v
MongoDB Atlas
     |
     v
Managed Database

Local MongoDB vs Atlas

Neither option is required for every learner—choose based on offline needs, ops comfort, and project goals. More on Atlas later.

MongoDB Connection String

mongodb://localhost:27017
mongodb://localhost:27017/mydb

mongodb://     → connection scheme
localhost      → server on this machine
27017          → default port (configurable)
/mydb          → optional default database name

Do not put production credentials in tutorials. A dedicated connection string page can cover auth and Atlas URIs later.

MongoDB Default Port

27017 is MongoDB’s common default port for mongod. It is a default, not a hard requirement. Configuration can change it; clients must match.

MongoDB Data Directory

mongod
  |
  v
Data directory (dbPath)
  |
  v
MongoDB data files

Paths depend on OS and method. Examples from common package installs: Linux apt often uses /var/lib/mongodb; macOS Homebrew uses a prefix under /usr/local/var/mongodb or /opt/homebrew/var/mongodb. Always confirm in your mongod configuration—do not treat one path as universal.

Configuration File

mongod can use a configuration file for storage, network binding, port, logging, and security. This is illustrative only—not a production template.

storage:
  dbPath: /path/to/data

net:
  port: 27017
  bindIp: 127.0.0.1

Default binding is often localhost-only. Do not expose MongoDB on public networks without authentication and proper security controls.

Stopping MongoDB

Prefer a graceful stop so the server can flush cleanly.

Do not treat killing the process as the normal shutdown procedure.

Installation Verification Checklist

✓ MongoDB Server installed
✓ mongod available (or Atlas deployment ready)
✓ MongoDB running
✓ mongosh available
✓ mongosh connects successfully
✓ ping command succeeds
✓ Document can be inserted
✓ Document can be read

Common Installation Problems

Do not delete database files as a generic “fix.” Investigate logs and configuration first.

Performance / Operational Notes

Security Notes

• Do not expose MongoDB directly to the public internet without proper security controls.
• Use authentication for secured deployments.
• Configure network binding deliberately (localhost-only is a common safe default for learning).
• Protect database credentials; do not put production secrets in tutorials.
• Use TLS where appropriate for production traffic.
• Follow MongoDB’s official security documentation for production deployments.

Do not bind MongoDB to all interfaces (for example 0.0.0.0) without understanding the exposure risk and enabling authentication.

Cheat Sheet

Key Takeaways