Install MongoDB Community Edition

You found the right tutorial: MongoDB is brilliant, but the installation process can feel like a minefield if you don't know where to start. How many times have you followed a blog post, only to hit a dead end because of a minor version mismatch or a missing repository? This lesson flips that script by guiding you through a clean, predictable install of MongoDB Community Edition on your own machine — no more guesswork, just a solid foundation for the rest of your MongoDB journey.

The problem this lesson solves

Manually downloading a MongoDB tarball, running binaries from random directories, and praying that mongod starts is a recipe for wasted hours and confusing configuration errors. Without a systematic install process, you'll struggle with:

• Inconsistent versions: You might end up with a dev version that behaves differently from production.
• Missing service management: On Linux, if MongoDB isn't registered as a service, it won't auto-start after a reboot.
• Path issues: Running mongod from a different directory can cause data and log paths to be misinterpreted.

This lesson installs MongoDB Community Edition (the free, open-source version) using your operating system's native package manager. We'll cover Ubuntu (or Debian-based), macOS (Homebrew), and Windows (MSI installer), so you have a working mongod and mongosh command in your terminal before moving on.

Core concept / mental model

Think of installing MongoDB like setting up a local database server — it's a daemon that listens on a port (default 27017) and responds to queries. The core pieces are:

• mongod: The database service (daemon). It handles data storage and query processing.
• mongosh: The modern shell client that lets you interact with the server.
• mongod.conf: The configuration file that defines data directories, log paths, and network bindings.

Mental model: MongoDB is like a post office that stores parcels (documents). mongod is the post office building, mongosh is the postal clerk's window, and the data directory is the sorting room. Until the building is installed and opened, you can't send or receive anything.

How it works step by step

Before running commands, you need to understand the logical flow:

1. Add the official MongoDB repository to your package manager. This ensures you get the mongodb-org package directly from MongoDB, not an outdated or mismatched version from your OS's default repos.
2. Install the MongoDB packages (mongodb-org includes the server, shell, and tools).
3. Start and enable the MongoDB service so it runs now and on boot.
4. Verify the install by connecting with mongosh.

For macOS with Homebrew, the process is simpler: tap the MongoDB formulas, install, and run the service via brew services.

For Windows, the MSI installer handles everything graphically, but you still need to configure the service and optionally the path.

Hands-on walkthrough

Install on Ubuntu 22.04 (or Debian 11+)

First, update your package index and install required dependencies:

sudo apt update
sudo apt install -y gnupg curl

Next, import the MongoDB public GPG key and add the official repository. Replace jammy with your Ubuntu codename (e.g., focal for 20.04):

curl -fsSL https://pgp.mongodb.com/server-7.0.asc | \
  sudo gpg -o /usr/share/keyrings/mongodb-server-7.0.gpg \
  --dearmor

echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-7.0.gpg ] https://repo.mongodb.org/apt/ubuntu jammy/mongodb-org/7.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-7.0.list

Now update again and install MongoDB:

sudo apt update
sudo apt install -y mongodb-org

Start the service and enable it to launch on boot:

sudo systemctl start mongod
sudo systemctl enable mongod

Verify the service status:

sudo systemctl status mongod

You should see active (running). Now connect with the shell:

mongosh

Expected output: Current Mongosh Log ID: ... and a prompt like test> — you're in!

Install on macOS with Homebrew

If you don't have Homebrew, install it first: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Then tap the MongoDB formulas and install:

brew tap mongodb/brew
brew install mongodb-community@7.0

Run MongoDB as a service (auto-starts at login):

brew services start mongodb-community@7.0

Wait a few seconds, then verify:

mongosh

If the service fails, check the log at /usr/local/var/log/mongodb/mongo.log (Intel) or /opt/homebrew/var/log/mongodb/mongo.log (Apple Silicon).

Install on Windows via MSI

1. Download the MSI installer from the MongoDB Community Download Center.
2. Run the installer — leave the default settings, but make sure you check Install MongoDB Compass if you want a GUI.
3. Choose Install MongoDB as a Service and Run service as Network Service.
4. After installation, MongoDB runs automatically. To connect, open a command prompt and type mongosh.

Note: The MSI adds the bin directory to PATH, so you can run mongosh from any folder. If it doesn't work, restart your terminal or add C:\Program Files\MongoDB\Server\7.0\bin to PATH manually.

Compare options / when to choose what

If you're on Linux and will use MongoDB daily, use apt. If you're on macOS and want the simplest path, Homebrew wins. Windows users have no better option than the MSI. Docker is excellent for CI or when you want zero footprint on your host—but for this track, native installs are the focus.

Troubleshooting & edge cases

mongod: command not found

• Cause: The bin directory isn't in your PATH, or the install didn't complete.
• Fix: On Linux, reinstall with sudo apt install -y mongodb-org and check /usr/bin/mongod. On macOS, ensure /opt/homebrew/bin is in your shell PATH. On Windows, add the bin path manually.

Failed to start mongod.service: Unit mongod.service not found

• Cause: The service file wasn't created because the mongodb-org-server package didn't install properly.
• Fix: Reinstall with sudo apt install -y mongodb-org-server and then start the service.

mongosh: error: connect ECONNREFUSED 127.0.0.1:27017

• Cause: The MongoDB server isn't running.
• Fix: Start it manually: sudo systemctl start mongod (Linux) or brew services start mongodb-community@7.0 (macOS). For Windows, check Services and start MongoDB Server.

Data directory permission issues on Linux

• Cause: The default data dir /data/db is owned by root, but mongod runs as mongodb user.
• Fix: Use the default directories from the package (they're already set up). If you're using a manual tar install, run sudo mkdir -p /data/db && sudo chown -Rid -u/data/db.

Version mismatch errors

• Cause: You installed a different version than the repo provides.
• Fix: Always use the same major version for mongod and mongosh. If you need a specific minor, pin the version on install (e.g., mongodb-org=7.0.14).

What you learned & what's next

You've successfully installed MongoDB Community Edition on your machine, configured it as a background service, and verified it by connecting with mongosh. You now understand the core components (mongod, mongosh) and can start the server whenever you need it.

What’s next: With a running MongoDB, you're ready to dive into creating databases and collections. In the next lesson, you'll learn how to perform basic CRUD operations — inserting, querying, updating, and deleting documents — using mongosh. Those commands will become your daily toolkit for interacting with MongoDB.

Remember: The installation is only the start. The real magic happens when you begin storing and retrieving data!