Installing MongoDB

Introduction

You can run MongoDB three ways: (1) install the Community Server locally, (2) run a Docker container, or (3) use MongoDB Atlas — a free managed cluster in the cloud. For learning we recommend Atlas: 30-second setup, zero ops.

Understanding the topic

Install paths:

• Atlas (cloud) — sign up at cloud.mongodb.com, create M0 free cluster, get connection string.
• Docker — one command: docker run -d -p 27017:27017 mongo:7.
• Homebrew (macOS) — brew tap mongodb/brew && brew install mongodb-community.
• apt (Ubuntu) — add MongoDB's APT repo, then apt install -y mongodb-org.
• Windows — official MSI installer from the MongoDB downloads page.

Syntax reference

Verify the install:

# Start (Docker)
docker run -d --name mongo -p 27017:27017 mongo:7

# Connect using the new Mongo Shell
mongosh "mongodb://localhost:27017"

> show dbs
admin   40.00 KiB
config  60.00 KiB
local   72.00 KiB

Real-world use

Every real team uses Atlas in production: free TLS, automated backups, point-in-time recovery, multi-region replicas, and audit logs out of the box. Self-hosted is rare outside large enterprises with strict data residency rules.

Best practices

• Use Atlas free tier (M0) for prototypes — no credit card required.
• Install mongosh (the modern shell) — the old mongo CLI is deprecated.
• Always set a strong root password, even locally — habits matter.

Common mistakes

• Don't expose port 27017 to the internet without auth — it's the #1 ransomware vector for MongoDB.
• Running multiple versions side-by-side can corrupt data files — pick one major version.