Apache HTTP Server Docker Container Image

• Docker images
• Environment variables
• Enabled modules
• Virtual host presets
  • HTML
  • PHP (FastCGI)
• Customization
• Orchestration actions

Docker Images

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

Overview:

• All images based on Alpine Linux
• Base image: _/httpd
• GitHub actions builds
• Docker Hub

Supported tags and respective Dockerfile links:

• 2.4, 2, latest (Dockerfile)

All images built for linux/amd64 and linux/arm64

Environment Variables

Variable	Default Value	Description
APACHE_ALLOW_OVERRIDE_ENABLED	All
APACHE_DIRECTORY_INDEX	index.html
APACHE_GROUP	apache
APACHE_HOSTNAME_LOOKUPS	Off
APACHE_HTTP2
APACHE_INCLUDE_CONF	conf/conf.d/*.conf
APACHE_INDEXES_ENABLED
APACHE_KEEP_ALIVE_TIMEOUT	5
APACHE_KEEP_ALIVE	On
APACHE_LIMITED_ACCESS
APACHE_LOG_LEVEL	warn
APACHE_MAX_KEEP_ALIVE_REQUESTS	100
APACHE_MPM_EVENT_MAX_CLIENTS	400
APACHE_MPM_EVENT_SERVER_LIMIT	16
APACHE_MPM_EVENT_START_SERVERS	3
APACHE_MPM_EVENT_THREAD_LIMIT	64
APACHE_MPM_EVENT_THREADS_PER_CHILD	25
APACHE_MPM	event
APACHE_PORT	80
APACHE_REQUEST_READ_TIMEOUT	header=20-40,MinRate=500 body=20,MinRate=500
APACHE_SERVER_NAME	default
APACHE_SERVER_NAME	default
APACHE_SERVER_SIGNATURE	Off
APACHE_SERVER_TOKENS	Full
APACHE_TIMEOUT	60
APACHE_USE_CANONICAL_NAME	Off
APACHE_USER	apache
APACHE_VHOST_PRESET	html

Enabled Modules

The list of installed modules: https://github.com/wodby/apache/blob/master/tests/basic/apache_modules

Virtual hosts presets

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

HTML

This is the default preset.

• Preset template
• Usage: this preset selected by default

PHP (FastCGI)

Additional environment variables for PHP preset:

Variable	Default Value	Description
APACHE_BACKEND_HOST	php
APACHE_BACKEND_PORT	9000
APACHE_DIRECTORY_INDEX	index.php
APACHE_FCGI_PROXY_CONN_TIMEOUT	5
APACHE_FCGI_PROXY_TIMEOUT	60

• Preset template
• Usage: add APACHE_VHOST_PRESET=php, optionally modify APACHE_BACKEND_HOST

Customization

If you can't customize a config via environment variables, you can completely override include of the virtual host config by overriding APACHE_INCLUDE_CONF, it will be included in httpd.conf.

Orchestration actions

Usage:

make COMMAND [params ...]

commands:
    check-ready [host max_try wait_seconds]
 
default params values:
    host localhost
    max_try 1
    wait_seconds 1
    delay_seconds 0