How to Create and Run an NGINX Container Using Docker


NGINX is a powerful, high-performance web server that is also used as a reverse proxy, HTTP cache, and load balancer. Using Docker to deploy an NGINX container is an efficient way to manage the configurations and lifecycle of the web server. This article guides you through the process of setting up an NGINX container, which is a perfect starting point for both development and production environments.

Step-by-Step Guide to Creating an NGINX Docker Container

1. Install Docker

First, ensure Docker is installed on your machine. For detailed instructions, refer to the official Docker installation guide.

2. Pull the NGINX Image

Start by pulling the official NGINX image from Docker Hub. Open a terminal and execute the following command:

docker pull nginx

This command downloads the latest NGINX image, ensuring you have the most recent version of the server.

3. Run the NGINX Container

To run NGINX in a container, use the following command:

docker run --name my-nginx -p 8080:80 -d nginx
  • --name my-nginx gives your container a name.

  • -p 8080:80 maps port 80 of the container to port 8080 on your host. This allows you to access the NGINX server by visiting http://localhost:8080 on your local machine.

  • -d runs the container in detached mode, letting it run in the background.

4. Verify the Container and NGINX are Running

Check that your container is running with the following command:

docker ps

Visit http://localhost:8080 in your web browser. You should see the default NGINX landing page. This confirms that NGINX is running successfully within your Docker container.

5. Customizing NGINX Configuration

To customize NGINX, you'll need to modify the NGINX configuration files. First, you can start by copying the default configuration from the container to your host:

docker cp my-nginx:/etc/nginx/nginx.conf ./nginx.conf

Edit nginx.conf on your host as needed and then copy it back to the container:

docker cp nginx.conf my-nginx:/etc/nginx/nginx.conf

After copying the modified configuration file back to the container, restart the container to apply the changes:

docker restart my-nginx

Why Use an NGINX Docker Container?

  • Simplicity: Docker simplifies the setup and configuration of NGINX, especially when dealing with multiple environments.

  • Isolation: Running NGINX inside a container ensures that your web server environment is isolated from other applications.

  • Scalability: Containers make it easier to scale your web server horizontally, i.e., adding more instances as demand requires.


Setting up an NGINX server in a Docker container is a straightforward process that offers flexibility, isolation, and scalability for web server management. Docker containers simplify the deployment and scaling of web applications, making it an ideal choice for developers looking to enhance their infrastructure.

For more detailed information on NGINX configuration and Docker best practices, visit the official NGINX Docker image page.