🐳 MERN Docker Starter — Complete Beginner to Entry-Level Guide

A clean, end-to-end MERN stack setup using Docker and Docker Compose. This repository is designed for first-time Docker users who want a smooth full-stack workflow.

---

🎯 Project Goal

• Run a full MERN stack using Docker
• Understand images, containers, volumes, and networking
• Enable reproducible development environments
• Prepare for production-ready container workflows

---

🧱 Tech Stack

• Frontend: React (Vite)
• Backend: Node.js + Express
• Database: MongoDB (containerized)
• DB GUI: Mongo Express
• Containerization: Docker + Docker Compose

---

📁 Project Structure

mern-docker-app/
│
├── client/              # React frontend
├── server/              # Express backend
├── docker-compose.yml   # Multi-container orchestration
├── .dockerignore
└── README.md

---

🚀 Quick Start (TL;DR)

1️⃣ Prerequisites

• Docker installed
• Docker Compose available
• Git installed

Verify:

docker --version
docker compose version

---

2️⃣ Start the Full Stack

From project root:

docker compose up -d --build

---

3️⃣ Open in Browser

Service	URL
Frontend	http://localhost:5173
Backend	http://localhost:5000
Mongo Express	http://localhost:8081

---

4️⃣ Stop the Project

docker compose down

---

🧠 How the Architecture Works

Browser
  ↓
Frontend Container (Vite)
  ↓
Backend Container (Express)
  ↓
MongoDB Container
  ↓
Mongo Express (GUI)

All services communicate via Docker network.

---

🔑 Important Concepts

• Image → blueprint
• Container → running instance
• Volume → persistent storage
• Network → container communication
• Compose → multi-service manager

---

---

📚 DOCKER LEARNING NOTES (10 CHAPTERS)

---

📘 Chapter 1 — Why Docker Exists

Problem

“Works on my machine” issue due to environment differences.

Common causes:

• Node version mismatch
• Missing dependencies
• OS differences
• Library conflicts

Docker Solution

Docker packages:

• application
• runtime
• dependencies
• configs

Result:

• portable
• consistent
• reproducible

---

📘 Chapter 2 — Core Terminology

Image

• Read-only blueprint
• Contains app + runtime
• Built from Dockerfile

Container

• Running instance of image
• Isolated environment
• Ephemeral by default

Docker Engine

• Core runtime that manages containers

Docker Hub

• Public registry for images

---

📘 Chapter 3 — Basic Commands

Essential commands:

docker run hello-world
docker ps
docker ps -a
docker stop <id>
docker rm <id>
docker images

Key learning:

Docker can run software instantly without installing locally.

---

📘 Chapter 4 — Images Deep Dive

Key Ideas

• Images are layered
• Layers enable caching
• Smaller images deploy faster
• Prefer specific tags (not latest)

Example:

docker pull node:18-alpine

---

📘 Chapter 5 — Dockerfile Mastery

Core Instructions

• FROM
• WORKDIR
• COPY
• RUN
• CMD
• EXPOSE

Backend Example

FROM node:18-alpine
WORKDIR /app
COPY package*.json ./
RUN npm install
COPY . .
CMD ["node", "server.js"]

Optimization Rule

Copy package.json first to leverage layer caching.

---

📘 Chapter 6 — Volumes & Persistence

Default Behavior

Containers are ephemeral.

Data inside container → lost on removal.

Solution

Use Docker volumes.

Example:

docker volume create mongo-data

When to Use

• Databases
• uploads
• persistent state

---

📘 Chapter 7 — Networking

Key Rule

Inside containers:

localhost refers to the container itself.

Container-to-Container

Use service name:

mongodb://mongo-db:27017

Host-to-Container

Use port mapping:

-p 5000:5000

---

📘 Chapter 8 — Docker Compose

Purpose

Run multi-container apps with one command.

Key File

docker-compose.yml

Most Used Commands

docker compose up -d
docker compose down
docker compose ps
docker compose logs

MERN Advantage

Compose runs:

• frontend
• backend
• database

together.

---

📘 Chapter 9 — Best Practices

Always Use

• .dockerignore
• specific image tags
• environment variables
• named volumes

Avoid

• latest tag
• hardcoded secrets
• unnecessary large images

Rebuild Rule

After Dockerfile change:

docker compose up -d --build

---

📘 Chapter 10 — Real-World Workflow

Development Flow

docker compose up
↓
code
↓
test
↓
docker compose down

Production Flow

GitHub push
↓
CI builds image
↓
Server runs container

Recommended Production Pattern

• containers are stateless
• database is managed (e.g., MongoDB Atlas)
• environment variables used

---

🧪 Troubleshooting Guide

Port Already in Use

sudo lsof -i :<port>

---

Container Not Starting

docker compose logs <service>

---

Rebuild After Changes

docker compose up -d --build

---

🏁 Current Skill Level

After completing this setup, you can:

• dockerize Node/React apps
• manage multi-container systems
• debug container issues
• handle volumes and networking
• run MERN stack via Docker

✅ Entry-level Docker competency achieved

---

🚀 Future Improvements

• Production React build + nginx
• MongoDB Atlas integration
• CI/CD pipelines
• Multi-stage Docker builds
• Kubernetes (advanced)

---

👨‍💻 Author

Built as a hands-on Docker learning project for MERN developers.

---

⭐ If This Helped

Consider starring the repo and sharing with fellow developers.

Happy Containerizing! 🐳