Awesome

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