Custom config in Docker in Nginx - Mini Project: Build & Apply

Custom config in Docker

📖 Scenario: You want to run a simple web server using nginx inside a Docker container. Instead of using the default settings, you want to provide your own custom configuration file to control how the server behaves.This is like setting up your own rules for how a coffee machine works instead of using the factory settings.

🎯 Goal: Build a Docker setup that uses a custom nginx.conf file to configure the nginx server inside a Docker container.You will create the custom config file, write a Dockerfile to use it, and then run the container to see your custom settings in action.

📋 What You'll Learn

Create a custom nginx.conf file with a simple server block

Write a Dockerfile that copies the custom config into the container

Use the official nginx image as the base

Run the container and verify the custom config is used

💡 Why This Matters

🌍 Real World

Customizing nginx configuration inside Docker containers is common when deploying web servers with specific rules or behaviors.

💼 Career

DevOps engineers often need to create Docker images with custom configurations to ensure applications run correctly in different environments.

1

Create the custom nginx.conf file

Create a file named nginx.conf with this exact content:

events {
    worker_connections 1024;
}
http {
    server {
        listen 8080;
        location / {
            return 200 'Hello from custom nginx config!';
        }
    }
}

Nginx

# Create the nginx.conf file with the custom server block
# Your code here

Need a hint?

This file tells nginx to listen on port 8080 and respond with a simple message.

2

Write the Dockerfile to use the custom config

Create a file named Dockerfile with these exact lines:

FROM nginx:latest
COPY nginx.conf /etc/nginx/nginx.conf

Nginx

events {
    worker_connections 1024;
}
http {
    server {
        listen 8080;
        location / {
            return 200 'Hello from custom nginx config!';
        }
    }
}

# Create the Dockerfile with FROM and COPY commands
# Your code here

Need a hint?

This Dockerfile uses the official nginx image and replaces the default config with your custom one.

3

Build and run the Docker container

Write these exact commands to build and run the Docker container:

docker build -t custom-nginx .
docker run -d -p 8080:8080 --name mynginx custom-nginx

Nginx

FROM nginx:latest
COPY nginx.conf /etc/nginx/nginx.conf

# Build the Docker image and run the container
# Your code here

Need a hint?

These commands create the image and start the container mapping port 8080.

4

Verify the custom nginx config is working

Run this exact command to check the server response:

curl -s http://localhost:8080

It should output:

Hello from custom nginx config!

Nginx

docker build -t custom-nginx .
docker run -d -p 8080:8080 --name mynginx custom-nginx

# Run curl to verify the server response
# Your code here

Need a hint?

This command asks the server for the homepage and shows your custom message.