Hello World Web 👋

🐙 GitHub Repository: albertrodriguezdev/docker-hello-world-web
🐳 Docker Hub Image: albertrodriguezdev/hello-world-web

---

A lightweight Docker HTTP web server container exposing port 8080 and returning a simple "Hello World" response.

Ideal as a simple Docker example image, lightweight HTTP test container, or minimal web server for demos and workshops.

No configuration required — just run and open your browser.

✨ What is hello-world-web?

hello-world-web is a tiny containerized web server that:

• Exposes port 8080
• Returns: Hello World from Docker! 🚀

It is intentionally small, predictable, and easy to run in any Docker environment.

Works out of the box with Docker Desktop and any modern Docker installation.

---

⚡ Run from Docker Hub

Use the prebuilt image published on Docker Hub.

🚀 Using Docker Compose (recommended)

Clone this repository and run:

docker compose up

Then open:

http://localhost:8080

Stop with:

Ctrl + C

🐳 Using Docker (alternative)

docker run -p 8080:8080 albertrodriguezdev/hello-world-web

To use a different host port:

docker run -p 3000:8080 albertrodriguezdev/hello-world-web

Then open in your browser:

• http://localhost:8080 (default port mapping: -p 8080:8080)
• http://localhost:3000 (if you used -p 3000:8080)

Stop with:

Ctrl + C

🛠 Run locally from source (advanced)

Build the image:

docker build -t hello-world-web .

Run the container:

docker run -p 8080:8080 hello-world-web

To use a different host port:

docker run -p 3000:8080 hello-world-web

Then open in your browser:

• http://localhost:8080 (default port mapping: -p 8080:8080)
• http://localhost:3000 (if you used -p 3000:8080)

Stop with:

Ctrl + C

✅ Example

curl http://localhost:8080

Response:

Hello World from Docker! 🚀

📁 Project structure

.
├── Dockerfile
├── docker-compose.yml
├── app.py
├── LICENSE
└── README.md

🧩 File overview

Dockerfile

Defines how the image is built and how the server starts.

docker-compose.yml

Defines the local service configuration and port publishing.

app.py

Minimal Flask-based HTTP server returning "Hello World".

---

Simple, predictable, and ready to use.