Welcome to your custom NGINX index file.
``` 3\. Next, on the command line, invoke `docker run` with nearly all the same parameters as step three in the previous section. But this time, include the volume parameter, `-v` as shown below. In the example below, the `-v` parameter is mapping the local _C:\\Articles\\NGINX_ directory to the image’s _/usr/share/nginx/html_ directory. Creating this mapping will allow you to modify the contents of the _/usr/share/nginx/html_ container directory by modifying the contents of the _C:\\Articles\\NGINX_ directory. > _This demonstrates a Windows file location, but this command works the same on Linux. For example, `-v /usr/share/myfiles:/usr/share/nginx/html`._ ```docker docker run -i -t -v c:\Articles\NGINX:/usr/share/nginx/html --name nginx-mainline -p 80:80 nginx:mainline-alpine ```  V parameter mapping 4\. Finally, open a web browser and navigate to _[http://localhost](http://localhost)_. You will see the following displayed based on the newly created _index.html_ file since it is now pulling files from the local _C:\\Articles\\NGINX_ directory.  Demonstrating the mapped _index.html_ file. ## Running a PHP-FPM Application with a Docker NGINX Container By now, you can bring up an NGINX Docker container and easily modify a website’s contents. If you need a super-basic setup, this might work. But, if you plan on running a web application on NGINX, you must do a little more work. As an example, let’s enable the NGINX image just created to run the popular web scripting language PHP using [PHP FastCGI Process Manager (FPM)](https://www.php.net/manual/en/install.fpm.php). For this section, several new concepts must be introduced. To easily define a set of containers and their linkages, it is best to use a [Docker Compose](https://docs.docker.com/compose/) file. Docker Compose defines the series of services and related applications in a [YAML (Yet Another Markup Language)](https://yaml.org/) file. Related:[Everything You Need to Know about Using Docker Compose](https://adamtheautomator.com/docker-compose-tutorial/) In addition, since you need to copy a custom configuration file for the default site, into the NGINX container, a custom version of the `nginx:mainline-alpine` image is needed. To extend an existing image, a _[dockerfile](https://docs.docker.com/engine/reference/builder/)_ is used and built with the `build` step in the Docker Compose file. 1\. Create a directory to contain your configuration files. In this example, the directory _C:\\Articles\\NGINXPHP_ is used. 2\. First, create the file, _dockerfile_, with the following contents. ```docker # The image to pull the base configuration from FROM nginx:mainline-alpine # The directory where any additional files will be referenced WORKDIR C:\Articles\NGINXPHP # Copy the custom default.conf from the WORKDIR (.) and overwrite the existing internal configuration in the NGINX container COPY ./default.conf /etc/nginx/conf.d/default.conf ``` 3\. Next, create the file _docker-compose.yml_ file, containing the following. ```yaml # The specification version of docker-compose version: "3.9" # The collection of applications composing this service services: # The NGINX custom container web: # Instead of referencing image: nginx:mainline-alpine here, use build to # reference the current directory (.), which will look for a dockerfile # by default build: . # The external directory location to map to an internal location volumes: - C:\Articles\NGINXPHP:/usr/share/nginx/html # The external port mapping to internal port mapping ports: - "80:80" php: image: php:fpm-alpine # It is important that both containers can reference the same files volumes: - C:\Articles\NGINXPHP:/usr/share/nginx/html ``` 4\. Finally, create the NGINX configuration file, _default.conf_, with the following. ```yaml server { # The port to listen on listen 80; # The root directory, which must exactly match the internal volume share root /usr/share/nginx/html; # For all files with the PHP extension run the following location ~ ^/.+\.php(/|$) { # Pass the request to the host "php" and port 9000 (default PHP-FPM port) fastcgi_pass php:9000; # Include the default NGINX FastCGI Parameters include fastcgi_params; # Define one additional parameter telling PHP-FPM where to find the file fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; } } ``` > _You may wonder where “PHP” for the hostname came from. By default, a network shared by all applications contained in the service is created using the name of the parent directory. Each container is assigned a hostname equal to the application name. In this example, the network is `nginxphp` and the hostnames are `web` and `php`._ 5\. In a terminal session, navigate to your custom Docker configuration file directory, which in this example is _C:\\Articles\\NGINXPHP_. Run the command, `docker-compose up` to generate and start your custom service.  Starting the set of containers specified in Docker Compose. 6\. Now that the set of containers are up and running, you need a PHP file to test the configuration out. Create the file, _index.php_, in your NGINX Docker shared directory which is _C:\\Articles\\NGINXPHP_ in this tutorial. ```php ``` 7\. Open a web browser and navigate to http://localhost/index.php to verify that the PHP file is properly shown.  Verifying PHP file ## Conclusion Docker NGINX containers are incredibly useful for testing and development. With proper care and attention, Docker containers can help to greatly increase a production web server’s capability as well! Now that you have successfully provisioned an NGINX container and a linked PHP-FPM container, try adding a database container into the mix for a full web application environment. Share this article [Share on X](https://twitter.com/intent/tweet?url=https%3A%2F%2Fadamtheautomator.com%2Fnginx-on-docker%2F&text=Provision%20NGINX%20on%20Docker%20and%20Increase%20Server%20Capabilities)[Share on Facebook](https://www.facebook.com/sharer/sharer.php?u=https%3A%2F%2Fadamtheautomator.com%2Fnginx-on-docker%2F)[Share on LinkedIn](https://www.linkedin.com/sharing/share-offsite/?url=https%3A%2F%2Fadamtheautomator.com%2Fnginx-on-docker%2F) ## Related Posts  ### [Create an NGINX Reverse Proxy in Docker and Learn 1 New Skill!](/nginx-reverse-proxy-in-docker/) Learn how to set up an NGINX reverse proxy in Docker using PHP-FM and NodeJS in this step-by-step tutorial.  ### [Azure Container Apps: Instant Preview Environments per PR](/build-ephemeral-preview-environments-every-pr/) Build isolated preview environments for every pull request using Azure Container Apps revision labels and Azure DevOps pipelines with scale-to-zero economics.  ### [Automating Docker Container Health Checks with Python and Local Notifications](/docker-health-checks-python/) Docker's built-in health checks are passive—they tell Docker when a container fails, but do they tell you? In this tutorial, we'll build a lightweight Python monitoring system that runs entirely on your infrastructure with zero external dependencies. You'll learn to detect container failures in real-time, send instant alerts, and maintain a complete audit log of every state change. ## Categories * [IT Ops](/category/it-ops/) * [Cloud](/category/cloud/) * [DevOps](/category/devops/) * [Home Ops](/category/home-ops/) * [Information Security](/category/infosec/) * [Software Development](/category/software-development/) ## Site * [Home](/) * [Tutorials](/tutorials/) * [Instructors](/author/) * [Advertising](/advertising/) * [Recommended Resources](/resources/) * [About Adam](/about-adam/) Copyright 2026© ATA Learning | [Privacy Policy](/privacy/)