How to Install MongoDB on Windows, Linux & macOS (Step-by-Step)

🧰 Installing MongoDB: A Simple Guide for Everyone

Welcome to this tutorial on installing MongoDB.

MongoDB is like a super smart digital filing cabinet that helps you store and organize large amounts of information quickly and easily. It is widely used by websites, apps, and games to manage data.

Whether you're a beginner just starting out or an expert needing a quick refresher, this guide will help you install MongoDB on Windows, Linux, or macOS.

Think of MongoDB as a box of LEGO bricks: each “brick” holds information, and you can stack them however you want. There are no strict table rules like traditional databases.

---

📑 Table of Contents

• What is MongoDB?
• System Requirements
• Method 1: Install Using Package Managers
  • Linux
  • macOS
  • Windows
• Method 2: Manual Installation
  • Windows Manual
  • Linux Manual
  • macOS Manual
• Verifying Installation
• Post-Installation Best Practices
• Uninstall / Upgrade MongoDB
• Performance Tips
• Tools and Next Steps
• ❓ Frequently Asked Questions (FAQ)

---

📖 What is MongoDB and Why Use It?

MongoDB is a NoSQL database, meaning it doesn’t use tables like old-school relational databases. Instead, it stores data in flexible “documents” similar to JSON files.

Benefits:

• For beginners: Easy to learn, no complex SQL needed.
• For experts: Scalable, supports sharding, and offers powerful querying.

---

🧪 System Requirements

OS	Minimum Version	Notes
Windows	64-bit, Windows 10+	Chocolatey or manual install
Linux	Ubuntu 20.04+, CentOS 8+	APT or manual install supported
macOS	11 (Big Sur)+	Intel & Apple Silicon supported

👉 Download MongoDB from the official website: https://www.mongodb.com

---

⚡ Method 1: Install Using Package Managers (Recommended)

Package managers are like app stores for your computer, handling downloads, installations, and updates automatically.

🐧 Linux (Ubuntu/Debian)

1. Update your system:

   sudo apt update
   sudo apt upgrade -y

2. Add MongoDB GPG key & repository:

   wget -qO - https://www.mongodb.org/static/pgp/server-7.0.asc | sudo apt-key add -
   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
   sudo apt update

3. Install MongoDB:

   sudo apt install -y mongodb-org

4. Start and enable MongoDB:

   sudo systemctl start mongod
   sudo systemctl enable mongod

5. Test the installation:

   mongosh
   > db.version()

💡 Pro Tip: Use mongod --config /etc/mongod.conf for custom configs (e.g., bind IP or authentication).

🍎 macOS (Homebrew)

1. Install Homebrew:

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. Tap and install MongoDB:

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

3. Start MongoDB as a service:

   brew services start mongodb/brew/mongodb-community

4. Or run manually:

   mongod --config /opt/homebrew/etc/mongod.conf

5. Test:

   mongosh

🪟 Windows (Chocolatey)

1. Install Chocolatey from https://chocolatey.org.
2. Open PowerShell as Administrator and run:

   choco install mongodb

3. MongoDB installs as a Windows service and starts automatically.
4. Test:

   mongosh

⚠️ If Chocolatey isn’t available, use the manual installation method below.

---

🧰 Method 2: Manual Installation (For More Control)

This method is great for learning how MongoDB works under the hood or troubleshooting advanced setups.

🪟 Windows Manual Installation

1. Download the MSI installer from MongoDB download page.
2. Run the installer, choose “Complete” setup, and check “Install MongoDB as a Service”.
3. Create the data directory:

   mkdir C:\data\db

4. Start MongoDB manually (if not installed as a service):

   "C:\Program Files\MongoDB\Server\7.0\bin\mongod.exe"

5. (Optional) Add MongoDB to PATH:

   C:\Program Files\MongoDB\Server\7.0\bin

6. Troubleshooting:
   • If port 27017 is busy, change port with --port 27018.
   • Advanced config: edit mongod.cfg in the install directory.

🐧 Linux Manual Installation (e.g., CentOS/RHEL)

1. Download the TGZ package for your distro.
2. Extract and move:

   tar -xzf mongodb-linux-x86_64-7.0.tgz
   sudo mkdir -p /opt/mongodb
   sudo mv mongodb-linux-x86_64-7.0 /opt/mongodb

3. Add to PATH:

   export PATH=$PATH:/opt/mongodb/bin
   source ~/.bashrc

4. Create the data directory:

   sudo mkdir -p /data/db
   sudo chown $(whoami) /data/db

5. Run MongoDB:

   mongod

🍎 macOS Manual Installation (Without Homebrew)

1. Download TGZ for macOS (Intel or ARM).
2. Extract and move:

   sudo mkdir -p /opt/mongodb
   sudo tar -xzf mongodb-macos-x86_64-7.0.tgz -C /opt/mongodb

3. Symlink binaries:

   sudo ln -s /opt/mongodb/bin/* /usr/local/bin/

4. Create data dir and run (same as Linux).
5. For Apple Silicon: use the ARM64 build and verify with:

   file mongod

---

✅ Verifying Installation (All OS)

1. Open MongoDB Shell:

   mongosh

2. Check connection:

   db.runCommand({ connectionStatus: 1 })

3. Check version:

   mongod --version

⚠️ If mongosh isn’t found, make sure your PATH includes the bin directory.

---

🔐 Post-Installation Best Practices

Enable Authentication

use admin
db.createUser({
  user: "admin",
  pwd: "strongpassword",
  roles: ["userAdminAnyDatabase", "dbAdminAnyDatabase", "readWriteAnyDatabase"]
})

Edit mongod.conf:

security:
  authorization: enabled

Restart MongoDB service after making changes.

Bind IP & Firewall

• Bind IP: For remote access, set net.bindIp: 0.0.0.0 (secure with firewall).
• Firewall:
  • Windows: Allow port 27017
  • Linux: sudo ufw allow 27017
  • macOS: System Preferences → Security → Firewall

Updates

• Package Manager: sudo apt upgrade mongodb-org or brew upgrade
• Manual: Download new version and backup /data/db

---

🧹 Uninstall or Upgrade MongoDB

If you ever need to remove or upgrade MongoDB, here are quick steps by OS:

🐧 Linux (Ubuntu/Debian)

sudo systemctl stop mongod
sudo apt purge mongodb-org*
sudo rm -r /var/log/mongodb
sudo rm -r /var/lib/mongodb

🍎 macOS (Homebrew)

brew services stop mongodb/brew/mongodb-community
brew uninstall mongodb/brew/mongodb-community
rm -rf /usr/local/var/mongodb

🪟 Windows

1. Stop the MongoDB service from Services.msc or with:

   net stop MongoDB

2. Uninstall from Control Panel or:

   choco uninstall mongodb

3. Delete C:\data\db if you want to remove stored databases.

To upgrade, simply download the new version and follow the same installation method. Always backup your data directory before upgrading.

---

🚀 Performance Tips for Experts

• Use WiredTiger storage engine (default).
• Store storage.dbPath on SSD.
• Monitor performance with:

  mongostat

  or use MongoDB Compass GUI.

---

🧠 Tools and Next Steps

• MongoDB Compass: GUI tool to visualize databases.
• Drivers: Install via pip (Python), npm (Node.js), etc.
• Backup: Use mongodump for safe exports.

---

🔗 Official Documentation & References

• MongoDB Installation Documentation
• MongoDB Community Download Page
• Windows Installation Guide
• Ubuntu Installation Guide
• macOS Installation Guide

---

👉 Beginner project:

use mydb
db.users.insertOne({ name: "Alice", age: 10 })

🧭 Practice on a virtual machine first.
For issues, check logs in:

• /var/log/mongodb (Linux)
• Install dir (Windows/macOS)

---

❓ Frequently Asked Questions (FAQ)

1. How do I check if MongoDB is installed correctly?

Open your terminal or command prompt and run:

mongosh

If the shell opens, run:

db.runCommand({ connectionStatus: 1 })

You should see "ok" : 1 in the output.

2. Where is MongoDB installed on my system?

• Windows: C:\Program Files\MongoDB\Server\7.0\bin
• Linux: /usr/bin or /opt/mongodb/bin
• macOS: /usr/local/bin or Homebrew directory

3. What port does MongoDB use?

MongoDB uses port 27017 by default. You can change it in mongod.conf using:

net:
  port: 27018

4. How do I uninstall MongoDB?

Follow the uninstall steps in the Uninstall / Upgrade section of this article for your OS.

5. How do I secure my MongoDB installation?

• Enable authentication and create an admin user.
• Use net.bindIp: 127.0.0.1 or firewall rules to limit access.
• Keep your MongoDB version up to date.

6. Can I run MongoDB on a virtual machine?

Yes. MongoDB runs well on virtual machines or containers like Docker. This is a great way to practice without affecting your main system.

Feel free to ask in comment if you have any question or suggestions.🎉 Happy coding!