SERVER_ROOT missing from docker images

[skeemer]

I tried to get the SERVER_ROOT environment variable working that's shown in https://github.com/php/frankenphp/blob/main/caddy/frankenphp/Caddyfile which is linked to in the docker doc, https://frankenphp.dev/docs/docker/#how-to-tweak-the-configuration.

I couldn't get it to work any which way and even tried creating /etc/caddy/Caddyfile.d/something.caddyfile, also shown in the Caddyfile and still nothing.

I finally looked at the Caddyfile in the image and found the following. It doesn't have SERVER_ROOT or file globs to add. Why is this missing key things from the file referenced in the documentation? Is this a bug or bad documentation since it says "For convenience, a default Caddyfile containing useful environment variables is provided in the image." and links to a Caddyfile that's obviously not the same.

{
	{$CADDY_GLOBAL_OPTIONS}

	frankenphp {
		#worker /path/to/your/worker.php
		{$FRANKENPHP_CONFIG}
	}

	# https://caddyserver.com/docs/caddyfile/directives#sorting-algorithm
	order mercure after encode
	order vulcain after reverse_proxy
	order php_server before file_server
	order php before file_server
}

{$CADDY_EXTRA_CONFIG}

{$SERVER_NAME:localhost} {
	#log {
	#	# Redact the authorization query parameter that can be set by Mercure
	#	format filter {
	#		wrap console
	#		fields {
	#			uri query {
	#				replace authorization REDACTED
	#			}
	#		}
	#	}
	#}

	root * public/
	encode zstd br gzip

	# Uncomment the following lines to enable Mercure and Vulcain modules
	#mercure {
	#	# Transport to use (default to Bolt)
	#	transport_url {$MERCURE_TRANSPORT_URL:bolt:///data/mercure.db}
	#	# Publisher JWT key
	#	publisher_jwt {env.MERCURE_PUBLISHER_JWT_KEY} {env.MERCURE_PUBLISHER_JWT_ALG}
	#	# Subscriber JWT key
	#	subscriber_jwt {env.MERCURE_SUBSCRIBER_JWT_KEY} {env.MERCURE_SUBSCRIBER_JWT_ALG}
	#	# Allow anonymous subscribers (double-check that it's what you want)
	#	anonymous
	#	# Enable the subscription API (double-check that it's what you want)
	#	subscriptions
	#	# Extra directives
	#	{$MERCURE_EXTRA_DIRECTIVES}
	#}
	#vulcain

	{$CADDY_SERVER_EXTRA_DIRECTIVES}

	php_server
}

[henderkes]

You have not mentioned how you are running FrankenPHP. Right now the best we could do is roll a dice and give a standard answer based on that.

Let's avoid that, help us help you. There is no SERVER_ROOT mentioned in the docs either.

[skeemer]

1. The title includes "docker images" and I'm referencing the docker doc page. I'm not sure what's vague about that, please specify what other information would be helpful.
2. I didn't claim SERVER_ROOT was in the docs, but the docs say: "For convenience, a default Caddyfile containing useful environment variables is provided in the image." The linked file has SERVER_ROOT. Also considering there is nothing else in that section, I would expect the linked file to be the one used in the images.

[skeemer]

I found my issue. I was using the image tagged latest-php8.3-alpine which was too old.

The image tags "latest-phpxxx-xxx" haven't been pushed for more than a year.

Is this something that was deprecated? It'd be nice not to have to specify the FrankenPHP version.

[henderkes]

I'm not sure about that. @dunglas takes care of the Docker images.

[skeemer]

I think the answer to this is to use the 1-phpxxx-xxx images to for something similar to ^1.0. It would be nice to have something about this in the docs.