CodeAlpha_DockerWebServer

CodeAlpha DevOps Internship — Task 4: Web Server using Docker

A reproducible, production-style web server packaged in a Docker container. A static site is served by nginx from a small Alpine-based image, with a built-in container health check, one-command orchestration via Docker Compose, and a monitoring guide.

---

✨ What this demonstrates

• Docker containerization fundamentals (image, layers, build context)
• Writing a clean, pinned Dockerfile
• The full container lifecycle: build → run → inspect → stop → remove
• Health monitoring with HEALTHCHECK and a dedicated /healthz endpoint
• One-command orchestration with Docker Compose
• Troubleshooting and resource monitoring (docker stats, docker logs, docker inspect)

🧱 Architecture

Browser ──HTTP:8080──▶ Docker host ──:80──▶ [ nginx container ]
├─ /usr/share/nginx/html (static site)
└─ HEALTHCHECK → GET /healthz

📂 Project structure

CodeAlpha_DockerWebServer/
├── Dockerfile # builds the nginx image
├── docker-compose.yml # one-command run with healthcheck + restart policy
├── .dockerignore # keeps the build context small
├── nginx/
│ └── default.conf # nginx server config + /healthz endpoint
├── site/
│ ├── index.html # the served web page
│ └── styles.css
└── docs/
├── monitoring.md # health, logs, stats, troubleshooting
└── screenshots/ # demo screenshots

🚀 Quick start

Prerequisite: Docker installed and running.

Option A — Docker Compose (recommended)

docker compose up -d --build
# open http://localhost:8080
docker compose down # when finished

Option B — Plain Docker

docker build -t codealpha-webserver .
docker run -d --name codealpha-webserver -p 8080:80 codealpha-webserver
# open http://localhost:8080
docker stop codealpha-webserver && docker rm codealpha-webserver

❤️ Health & monitoring

# Health verdict: healthy / unhealthy
docker inspect --format '{{.State.Health.Status}}' codealpha-webserver
# Live resource usage
docker stats codealpha-webserver
# Health endpoint
curl http://localhost:8080/healthz # -> ok

See docs/monitoring.md for the full monitoring & troubleshooting guide.

🔧 Tech stack

Docker · Docker Compose · nginx (Alpine) · HTML/CSS

👤 Author

Ali — CodeAlpha DevOps Internship, 2026