NGINX

Environment variables

Variable	Path
USR_SRC	/usr/src
USR_SRC_NGINX	/usr/src/nginx
USR_SRC_NGINX_MODS	/usr/src/nginx/modules

Variable	Version
NGINX_VERSION	1.29.1
OPENSSL_VERSION	3.5.2
LIBMAXMINDDB_VERSION	1.12.2

Additional packages

• libbrotli-dev
• libmaxminddb-dev
• libclang-dev
• libssl-dev
• libxml2
• libxml2-dev
• libxslt1-dev
• mmdb-bin
• pkg-config
• uuid-dev
• zlib1g
• zlib1g-dev

Volumes

Path	Description
/etc/nginx	NGINX configurations
/var/log/nginx	NGINX logs
/var/www	Default www folder
/etc/letsencrypt	Let's Encrypt files (see certbot)
/usr/share/GeoIP	GeoIP database folder (see below)

Ports

Port	Process	TCP/UDP
80	NGINX	TCP
443	NGINX	TCP

Usage

To pull the image

docker pull gokaygurcan/nginx

To run an NGINX container

# clone this repository
git clone https://github.com/gokaygurcan/dockerfile-nginx.git

# cd into it
cd dockerfile-nginx

# run nginx with the default configurations
docker run --rm -d --name nginx -p 80:80 -p 443:443 \
  -v `pwd`/docker/etc/nginx:/etc/nginx \
  gokaygurcan/nginx

# see if cURL returns anything good
curl -i http://localhost

GeoIP

To use GeoIP, you need to download City and/or Country databases from MaxMind. The best way to do it is to use their Docker container.

# create a volume for persistency
docker volume create usr-share-geoip

# download geoip databases
docker run --rm --name geoipupdate \
  -v usr-share-geoip:/usr/share/GeoIP \
  -e GEOIPUPDATE_FREQUENCY=0 \
  -e GEOIPUPDATE_ACCOUNT_ID='<your account id>' \
  -e GEOIPUPDATE_LICENSE_KEY='<your license key>' \
  -e GEOIPUPDATE_EDITION_IDS='GeoLite2-City GeoLite2-Country' \
  maxmindinc/geoipupdate

# you can start nginx with this additional volume now
docker run --rm -d --name nginx -p 80:80 -p 443:443 \
  -v `pwd`/docker/etc/nginx:/etc/nginx \
  -v usr-share-geoip:/usr/share/GeoIP \
  gokaygurcan/nginx