🐳 Run with Docker Only
🐳 Run the App Stack with Docker Only
No Kubernetes needed
The course apps (nginx, App1, App2, BuggyApp) run with nothing but Docker + Docker Compose, using the docker-compose.yml at the repo root. This is the fastest way to run everything locally.
✅ Prerequisites
- Docker Desktop / OrbStack / colima running - that’s it 🙂
🚀 Build & run
From the repository root:
# Build all images in parallel (each service has its own Dockerfile under src/)
docker compose build
# Start the full stack in the background
docker compose up -d
# Watch the startup order & health checks
docker compose ps
Built-in startup order
Compose waits for health checks automatically: app1 must be healthy before app2 starts, and both must be healthy before nginx (the front door) launches.
🌐 Services & ports
| Service | Container port | Host port | Purpose |
|---|---|---|---|
| nginx | 80 | 8080 | Reverse proxy front door |
| App1 | 3000 | 5001 | Tiny REST receiver |
| App2 | 3000 | 5002 | Calls App1 over the Docker network |
| BuggyApp | 80 | 5006 | Intentionally buggy app for debugging practice |
🔍 Verify the call chain
# Health check every service
curl http://localhost:8080/health
curl http://localhost:8080/app1/health
curl http://localhost:8080/app2/health
# POST an event through nginx -> App1 (note the /app1 prefix is stripped)
curl -X POST http://localhost:8080/app1/api/receive \
-H "Content-Type: application/json" \
-d '{"message": "hello through nginx"}'
# App2 -> App1, over the Docker network (by service name)
curl http://localhost:8080/app2/api/call-app1
# Or hit the services directly, bypassing the proxy
curl -X POST http://localhost:5001/api/receive \
-H "Content-Type: application/json" \
-d '{"message": "hello app1"}'
# Prove the bug exists before the debugging task
curl -s -o /dev/null -w "%{http_code}\n" http://localhost:5006/process # 500
🧹 Teardown
➡️ Next steps
- Break it on purpose: BuggyApp · Build & Debug
- Meet the container runtimes behind Docker: Container Runtimes
- Start the labs from the beginning: Lab 001 · Docker CLI