Apache HTTP Server Docker Container Image

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

Docker Images

Use image revision tags such as wodby/apache:2.4-rN to select a Wodby image revision. Major and minor tags use the repository release number, starting at r0. Full-version tags such as wodby/apache:2.4.68-r0 start at r0 for each exact upstream version. Every published versioned revision tag has a matching annotated Git tag pointing to its release commit. Existing tags remain available after support for their major or minor version ends. See release tags for available revisions and the image revision policy for upgrade guidance. Previously published image tags remain available.

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

Building with pinned base images

Build with the Makefile to use the base image digests in base-images.mk. Local builds and CI resolve the same version and variant to the same multi-platform image. A version without a pin fails before the build starts.

When adding a supported base version or variant, add its image index digest to base-images.mk. For a custom build, override BASE_IMAGE with a complete repository:tag@sha256:... reference.