🗄️ Environment Variables

Full reference for every setting exposed by ruseler/alpine-php-webserver. Defaults come from the Dockerfile and are applied unless you override them.

Nginx

Variable	Default	Purpose
nginx_root_directory	/var/www/html	Document root for the default server block.
client_max_body_size	2M	Max allowed request body size. Raise for uploads.
fastcgi_read_timeout	60s	Max time waiting for a response from PHP-FPM.
fastcgi_send_timeout	60s	Max time transmitting a request to PHP-FPM.
DISABLE_DEFAULT_LOCATION	false	Comment out the built-in location / { ... } block so you can provide your own via /etc/nginx/server-conf.d/. See #43.

Trusted proxy / real IP

Real IP restoration is disabled by default. Configure REAL_IP_FROM with a strict allow-list of trusted proxies to enable it.

Variable	Default	Purpose
REAL_IP_HEADER	X-Forwarded-For	Header Nginx reads as the client IP (X-Forwarded-For, CF-Connecting-IP, X-Real-IP…).
REAL_IP_RECURSIVE	off	on = walk the trusted chain recursively.
REAL_IP_FROM	(empty)	Comma-separated list of trusted proxy IPs / CIDRs. Real IP stays disabled until this is set.

See Reverse Proxy & Trusted IPs for concrete recipes.

Never use broad public ranges

REAL_IP_FROM=0.0.0.0/0 would let any client spoof the configured header. Trust only proxies you control (internal CIDRs, Cloudflare's published ranges, your tunnel connector, etc.).

PHP runtime

Variable	Default	Purpose
clear_env	no	Keep env vars available to FPM workers.
allow_url_fopen	On	URL-aware fopen().
allow_url_include	Off	URL-aware include() / require(). Leave off.
display_errors	Off	Render errors in HTTP responses.
file_uploads	On	Enable HTTP uploads.
max_execution_time	0	Max seconds per script. 0 = unlimited.
max_input_time	-1	Max seconds parsing input. -1 = unlimited.
max_input_vars	1000	Max input vars per request.
memory_limit	128M	Per-request memory ceiling.
post_max_size	8M	Max POST body. Must exceed upload_max_filesize.
upload_max_filesize	2M	Max single file upload.
zlib_output_compression	On	Transparent output compression.
date_timezone	UTC	PHP date.timezone.
intl_default_locale	en_US	PHP intl.default_locale.

OPcache

Variable	Default	Purpose
opcache_enable	0	1 to enable OPcache.
opcache_memory_consumption	256	Shared memory in MB.
opcache_max_accelerated_files	20000	Max cached files.
opcache_validate_timestamps	0	1 revalidates on every request (dev); 0 never (prod).
opcache_preload	(empty)	Preload script path.
realpath_cache_size	4096K	Realpath cache size.
realpath_cache_ttl	600	Realpath cache TTL (seconds).

See PHP Configuration for usage notes and examples.

Adding your own variables

Anything not in this table can be injected via:

• /etc/nginx/conf.d/*.conf or /etc/nginx/server-conf.d/*.conf for Nginx directives
• /etc/php84/conf.d/NN-*.ini for PHP settings
• A custom image extending this one

See Extending the Image.

---

This documentation is a fork of erseco/alpine-php-webserver. The upstream documentation is available here.