Dockerized-Nginx (Good-Enough-4-me)

This is a project made using docker Ubuntu 26.04, NGINX, and PHP.
Meant to be a very barebones Docker for having a simple web server or proxy.

Installation

git clone https://github.com/bakedhorse/Dockerized-Nginx
cd Dockerized-Nginx
docker compose build
docker compose up -d

You can change the name of the Dockerized-Nginx folder to anything.

.env Configuration

The directory for the docker itself is set within .env. The default option is recommended, but is fine to change for unique setups.

APP_DIR=./

The Dockerfile itself has two parameter configurations in .env. Changing these requires re-building the Dockerfile image.

APT_UPDATE_ON_START=1

This parameter tells app.sh script will do apt update and apt upgrade on each start up. Would recommend having this disabled as this has a tendency to freeze randomly, along with this not saving any updated packages after a restart.

PHP_VERSION=8.5

This parameter tells what version of PHP to download and use. (php 8.5 is the current version in the official Ubuntu 26.04 repos)

Storage of WWW, NGINX, and PHP folders

These folders are mounted in a folder conf wherever your APP_DIR is set to. (It should be in the same folder on it's default setting.)

Any changes you want to make to NGINX, PHP, or your website files are done here.

NGINX PHP-FPM Configuration

Due to NGINX not having a PHP-FPM file by default, you need to add one. The scripts/ folder includes one and should've been copied into the nginx folder within conf/.
Add this into your nginx config for setting up a site or proxy.

include /etc/nginx/php_fpm;

An example like

server {
    port 80;
    server_name _;
    root /var/www/html;
    index index.html;
    include /etc/nginx/php_fpm;
}

Modules for NGINX

Due to the nature of NGINX's modules normally being baked in from the build process, there's a limited set of modules that can be used without building nginx from scratch. The modules that can be installed are called "dynamic modules".
This Dockerfile uses the official nginx.org Ubuntu repository, configured for the latest stable channel.
The build also compiles headers-more as a compatible dynamic module after nginx and PHP are installed, so ngx_http_headers_more_filter_module.so is available in the nginx modules directory after image creation.
Recommend going through the nginx.org package repo to find any additional packaged dynamic module you want and adding it in the additional-packages.txt in the modules folder. (THIS WILL REQUIRE THE DOCKERFILE IMAGE TO BE RE-BUILT)

The modules installed from apt are stored in /usr/share/nginx/modules/. When you go into this directory, look for each module's file name and copy it. Don't forget it's extension which is usually .so Then add a line into the nginx.conf script at the top for each module. (Replace <FILENAME> with the file name, duh)

load_module modules/<FILENAME>;

Example being

load_module modules/ngx_http_headers_more_filter_module.so;

Extensions for PHP

PHP is pulled from the ppa:ondrej/php repo. Recommended to find available extensions from here, or you can use the stock Ubuntu repos as well.
Recommend to put any extensions you want into php-extensions.txt without php- at the beginning.
(THIS WILL REQUIRE THE DOCKERFILE IMAGE TO BE RE-BUILT)

Will continue to work on this later. For now, it'll do.