Volume mounting for configs in Nginx - Mini Project: Build & Apply

Volume mounting for configs

📖 Scenario: You are setting up an nginx web server using Docker. To customize the server, you want to mount a configuration file from your local machine into the container. This way, you can easily change the server settings without rebuilding the image.

🎯 Goal: Learn how to mount a local nginx.conf file into the Docker container using a volume mount. This will let the container use your custom configuration.

📋 What You'll Learn

Create a local nginx.conf file with basic server settings

Write a Docker run command that mounts the local nginx.conf into the container's /etc/nginx/nginx.conf

Use the official nginx image from Docker Hub

Verify the container uses the mounted configuration

💡 Why This Matters

🌍 Real World

Developers and system administrators often customize server settings by mounting config files into containers. This makes updates fast and safe.

💼 Career

Understanding volume mounts is essential for managing containerized applications in real environments, a key skill for DevOps roles.

1

Create a local nginx configuration file

Create a file named nginx.conf in your current directory with this exact content:

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

Nginx

# Create the file nginx.conf with the exact content shown in the instruction

Need a hint?

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

2

Write the Docker run command with volume mount

Write a Docker command to run the official nginx image, mounting your local nginx.conf file into the container at /etc/nginx/nginx.conf. Use the option -v $(pwd)/nginx.conf:/etc/nginx/nginx.conf in the command.

Nginx

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

# Write the docker run command below
# Your code here

Need a hint?

The -v option mounts your local file into the container. $(pwd) gets your current directory path.

3

Run the container and check the server

Run the Docker command you wrote. Then use curl http://localhost:8080 to check the server response. The response should be Hello from custom config!.

Nginx

# Run the docker command below
# Your code here

# Run curl command below to check response
# Your code here

Need a hint?

The curl command fetches the page from your running nginx server.

4

Display the server response

Print the output of curl http://localhost:8080. It should exactly show Hello from custom config!.

Nginx

# The output should be printed automatically by curl
# Your code here

Need a hint?

If you see this message, your volume mount worked and nginx used your config.