richarvey/nginx-php-fpm

nginx-php-fpm - https://github.com/richarvey/nginx-php-fpm/actions/workflows/build_images.yml/badge.svg](https://github.com/richarvey/nginx-php-fpm/actions/workflows/build_images.yml) !docker hub !docker hub !Github !docker version

Overview

This is a Dockerfile/image to build a container for nginx and php-fpm, with the ability to pull website code from git when the container is created, as well as allowing the container to push and pull changes to the code to and from git. The container also has the ability to update templated files with variables passed to docker in order to update your code and settings. There is support for lets encrypt SSL configurations, custom nginx configs, core nginx/PHP variable overrides for running preferences, X-Forwarded-For headers and UID mapping for local volume support.

If you have improvements or suggestions please open an issue or pull request on the GitHub project page.

Versioning

For other tags please see: https://github.com/richarvey/nginx-php-fpm/blob/main/docs/versioning.md

NOTE: From 2.0.5 onwards there are x86 and arm64 builds available

Links

• https://github.com/richarvey/nginx-php-fpm
• https://hub.docker.com/repository/docker/richarvey/nginx-php-fpm/general

Quick Start

To pull from docker hub:

docker pull richarvey/nginx-php-fpm:latest

Running

To simply run the container:

sudo docker run -d richarvey/nginx-php-fpm

To dynamically pull code from git when starting:

docker run -d -e 'GIT_EMAIL=email_address' -e 'GIT_NAME=full_name' -e 'GIT_USERNAME=git_username' -e 'GIT_REPO=github.com/project' -e 'GIT_PERSONAL_TOKEN=<long_token_string_here>' richarvey/nginx-php-fpm:latest

You can then browse to http://<DOCKER_HOST> to view the default install files. To find your DOCKER_HOST use the docker inspect to get the IP address (normally 172.17.0.2)

For more detailed examples and explanations please refer to the documentation.

Documentation

• https://github.com/richarvey/nginx-php-fpm/blob/maindocs/building.md
• https://github.com/richarvey/nginx-php-fpm/blob/main/docs/versioning.md
• https://github.com/richarvey/nginx-php-fpm/blob/main/docs/config_flags.md
• https://github.com/richarvey/nginx-php-fpm/blob/main/docs/git_auth.md
  • https://github.com/richarvey/nginx-php-fpm/blob/main/docs/git_auth.md#personal-access-token
  • https://github.com/richarvey/nginx-php-fpm/blob/main/docs/git_auth.md#ssh-keys
• https://github.com/richarvey/nginx-php-fpm/blob/main/docs/git_commands.md
• https://github.com/richarvey/nginx-php-fpm/blob/main/docs/git_commands.md#push-code-to-git
• https://github.com/richarvey/nginx-php-fpm/blob/main/docs/git_commands.md#pull-code-from-git-refresh
• https://github.com/richarvey/nginx-php-fpm/blob/main/docs/repo_layout.md
• https://github.com/richarvey/nginx-php-fpm/blob/main/docs/repo_layout.md#src--webroot
• https://github.com/richarvey/nginx-php-fpm/blob/main/docs/UID_GID_Mapping.md
• https://github.com/richarvey/nginx-php-fpm/blob/main/docs/nginx_configs.md
• https://github.com/richarvey/nginx-php-fpm/blob/main/docs/nginx_configs.md#real-ip--x-forwarded-for-headers
• https://github.com/richarvey/nginx-php-fpm/blob/main/docs/scripting_templating.md
• https://github.com/richarvey/nginx-php-fpm/blob/main/docs/scripting_templating.md#using-environment-variables--templating
• https://github.com/richarvey/nginx-php-fpm/blob/main/docs/lets_encrypt.md
• https://github.com/richarvey/nginx-php-fpm/blob/main/docs/lets_encrypt.md#setup
• https://github.com/richarvey/nginx-php-fpm/blob/main/docs/lets_encrypt.md#renewal
• https://github.com/richarvey/nginx-php-fpm/blob/main/docs/php_modules.md
• https://github.com/richarvey/nginx-php-fpm/blob/main/docs/xdebug.md
• https://github.com/richarvey/nginx-php-fpm/blob/main/docs/logs.md

Guides

• https://github.com/richarvey/nginx-php-fpm/blob/main/docs/guides/kubernetes.md
• https://github.com/richarvey/nginx-php-fpm/blob/main/docs/guides/docker_compose.md