MongoDB Installation Guide

What You’ll Learn

This guide walks you through installing MongoDB Community Server on your machine, starting the mongod service, connecting with mongosh, and running your first database commands.

Definition and Usage

MongoDB is a document database. To use it locally you install MongoDB Community Server—the open-source edition that runs the mongod process on your computer. You then connect with mongosh, MongoDB’s modern shell, to create databases, insert documents, and run aggregations.

After installation you can follow MongoDB tutorials on CodeToFun—starting with aggregation operators and accumulators—using the same local instance.

🚀 Choose your setup path

This tutorial focuses on local Community Server installation—the foundation most beginners want before exploring Atlas or Docker.

Examples Gallery

Install steps for each platform, then verify and run your first commands in mongosh.

# Confirm mongosh is on PATH
mongosh --version

# Connect to local server
mongosh

brew tap mongodb/brew
brew install mongodb-community

# Start the server as a background service
brew services start mongodb-community

# Connect
mongosh

Current Mongosh Log ID: …
Connecting to: mongodb://127.0.0.1:27017
test>

sudo apt-get update
sudo apt-get install -y mongodb-org

sudo systemctl start mongod
sudo systemctl enable mongod

sudo systemctl status mongod
mongosh

mongosh

db.runCommand({ ping: 1 })

/* Expected:
{ ok: 1 }
*/

{ ok: 1 }

use codetofun_demo

db.users.insertOne({
  name: "Alex",
  role: "developer",
  joined: new Date()
})

db.users.findOne({ name: "Alex" })

/* Returns the document you inserted */
*/

{
  _id: ObjectId("…"),
  name: "Alex",
  role: "developer",
  joined: ISODate("…")
}

📝 Notes

• Default local installs have no authentication—fine for learning on your machine; enable auth before exposing to a network.
• Add the MongoDB bin folder to your PATH if mongosh is not recognized after install.
• On Windows, use Services (services.msc) to restart MongoDB if the shell cannot connect.
• Check logs when startup fails: Windows Event Viewer, macOS Homebrew logs, Linux /var/log/mongodb/mongod.log.
• MongoDB Compass is optional—it connects to the same URI as mongosh for visual browsing.
• Next topic: $add operator (aggregation expressions).

💡 Best Practices