[FEAT] how to disable php-fpm？

[shuosiw]

Is this a new feature request?

• I have searched the existing issues

Wanted change

If I don’t need PHP at all, is there a way to prevent it from starting—say, via an environment variable?

Now I'm setting this docker volume mount to disable php-fpm become running.

-v /opt/disable_php:/etc/php84

/opt/disable_php does not have any file.

When the container starts, php-fpm crashes and exits because it can’t find a valid configuration file, so the container ends up without a php-fpm process. However, this feels inelegant—startup still logs noisy error messages.

stderr: [24-Jul-2025 16:54:56] ERROR: failed to open configuration file '/etc/php84/php-fpm.conf': No such file or directory (2)
stderr: [24-Jul-2025 16:54:56] ERROR: failed to load configuration file '/etc/php84/php-fpm.conf'
stderr: [24-Jul-2025 16:54:56] ERROR: FPM initialization failed
stderr: [24-Jul-2025 16:54:57] ERROR: failed to open configuration file '/etc/php84/php-fpm.conf': No such file or directory (2)
stderr: [24-Jul-2025 16:54:57] ERROR: failed to load configuration file '/etc/php84/php-fpm.conf'
stderr: [24-Jul-2025 16:54:57] ERROR: FPM initialization failed

Reason for change

make the container clean.

Proposed code change

No response

[github-actions]

Thanks for opening your first issue here! Be sure to follow the relevant issue templates, or risk having this issue marked as invalid.

[drizuid]

it would be best to use a different container if you don't want php. We do not provide a mechanism to disable it, assuming this isn't something php can handle itself via config.

If you WANT to use linuxserver stuff, you could use baseimage-alpine:3.22 and then apk add --no-cache nginx openssl

[shuosiw]

oh, I have fixed it.

write a bash script and mount into container：

/opt/appdata/nginx/disable_php:/custom-cont-init.d:ro

it will disable php-fpm

#!/bin/bash

ps axu

# stop php-fpm service
{ sleep 5; s6-svc -d /run/s6-rc/servicedirs/svc-php-fpm; } &

# disable php-fpm service
touch /etc/s6-overlay/s6-rc.d/svc-php-fpm/down

[drizuid]

glad you got it sorted in a manner you are good with.