• Docker images
• Environment variables
• Nginx modules
• Virtual hosts presets
  • HTML
  • HTTP proxy (application server)
  • PHP-based (FastCGI)
    • PHP
    • WordPress
    • Drupal
  • Custom preset
  • No preset
• Customization
• Orchestration actions

❗For better reliability we release images with stability tags (wodby/nginx:1.15-X.X.X) which correspond to git tags. We strongly recommend using images only with stability tags.

Overview:

• All images are based on Alpine Linux
• Base image: wodby/alpine
• Travis CI builds
• Docker Hub

Supported tags and respective Dockerfile links:

• 1.15, 1, latest (Dockerfile)
• 1.14 (Dockerfile)
• 1.13 (Dockerfile)

Static files extension defined via the regex and can be overriden via the env var NGINX_STATIC_EXT_REGEX, default:

css|cur|js|jpe?g|gif|htc|ico|png|xml|otf|ttf|eot|woff|woff2|svg|mp4|svgz|ogg|ogv|pdf|pptx?|zip|tgz|gz|rar|bz2|doc|xls|exe|tar|mid|midi|wav|bmp|rtf|txt

Some environment variables can be overridden or added per preset.

By default will be used html virtual host preset, you can change it via env var $NGINX_VHOST_PRESET. The list of available presets:

This is the default preset.

• Preset template
• Usage: this preset selected by default

• Preset template
• Usage: add NGINX_VHOST_PRESET=http-proxy and NGINX_BACKEND_HOST=[host]

Additional environment variables for HTTP proxy preset:

Additional environment variables for all php-based presets:

• Preset template
• Usage: add NGINX_VHOST_PRESET=php, optionally modify NGINX_BACKEND_HOST
• $NGINX_INDEX_FILE set to index.php by default

• Preset template
• Usage: add NGINX_VHOST_PRESET=wordpress, optionally modify NGINX_BACKEND_HOST
• Access to *.txt files allowed only if they are located in uploads directory

Additional environment variables for Drupal presets:

• Preset templates: Drupal 8, Drupal 7, Drupal 6
• Usage: add NGINX_VHOST_PRESET= with the value of drupal8, drupal7 or drupal6. Optionally modify NGINX_BACKEND_HOST
• If you want to use stage_file_proxy module, set $NGINX_STATIC_404_TRY_INDEX=1 to redirect 404 static files requests to Drupal
• Access to *.txt files allowed only if they are located in files directory

You can use a custom by preset by mounting your preset to /etc/gotpl/presets/[my-preset-name].conf.tmpl and setting $NGINX_VHOST_PRESET=[my-preset-name].

To disable presets set $NGINX_VHOST_PRESET=""

• Disable default recommended headers via $NGINX_NO_DEFAULT_HEADERS (defined in nginx.conf)
• Disable default rules included in virtual host via $NGINX_VHOST_NO_DEFAULTS
• Add extra locations via $NGINX_SERVER_EXTRA_CONF_FILEPATH=/filepath/to/nginx-locations.conf, the file will be included at the end of virtual host config (server context)
• Define custom preset
• Completely override include of the virtual host config by overriding NGINX_CONF_INCLUDE, it will be included in nginx.conf

Usage:

make COMMAND [params ...]

commands:
    git-clone [url branch]
    git-checkout [target is_hash]
    check-ready [host max_try wait_seconds delay_seconds]
 
default params values:
    host localhost
    max_try 1
    wait_seconds 1
    delay_seconds 0
    is_hash 0
    branch ""