PHP-FPM Exits After 90 Seconds on Ubuntu: The systemd Type=notify Mismatch

Abstract: A self-compiled PHP-FPM binary is killed exactly 90 seconds after start because Ubuntu's service unit expects an sd_notify readiness message the binary never sends. Enable systemd integration at build time or adjust the ...

Created: 2026-11-02 by

When a self-compiled PHP-FPM binary is killed by systemd exactly 90 seconds after every start, the cause is almost always a service type mismatch: Ubuntu's php8.3-fpm.service unit declares Type=notify, which requires the binary to send a readiness notification via the systemd notify protocol. A PHP build without systemd integration never sends that message, so systemd concludes the service failed to start, kills it, and reports a timeout. The fix is to build PHP with systemd support enabled — or, less preferably, to change the unit's type.

What the 90-second delay actually means

The number 90 is not arbitrary. It is the default value of TimeoutStartSec in systemd. With a Type=notify unit, systemd considers the service "started" only when the process calls sd_notify() with the string READY=1. Until then, systemd waits — for 90 seconds by default — and if nothing arrives, it logs something like:

php8.3-fpm.service: start operation timed out. Terminating.

and sends SIGTERM to the process group. This explains the confusing symptoms that often accompany this problem:

  • PHP-FPM does start, listens on its socket, and serves requests correctly during those 90 seconds. Functionality is not the issue; the handshake is.
  • The log contains only a terse Terminating ... exiting, bye-bye!, because that is the PHP-FPM master process reacting to the termination signal, not reporting an internal error.
  • Running systemctl start php8.3-fpm appears to hang for the same 90 seconds — the command blocks until systemd gives up on the readiness notification.
  • The PID file exists and is current. PID files prove nothing here; with Type=notify, systemd does not use them to decide whether startup succeeded.

Why source builds break the handshake

Distribution-packaged PHP binaries are built with systemd notification support compiled in. When you download the PHP source tarball and configure it yourself, that integration is disabled by default. The resulting binary is a perfectly valid FPM server — it just never talks to systemd, so a unit expecting notification will always time out.

The general rule: any time you replace a packaged daemon with a hand-built binary, the service unit that ships with the package may no longer match the binary's behavior. Service type, socket paths, user settings, and configuration file locations all become candidates for drift.

The proper fix: compile PHP with systemd support

Reconfigure and rebuild PHP so the FPM binary includes the systemd integration:

./configure \
    --enable-fpm \
    --with-fpm-systemd \
    ...your other options...
make && make install

With --with-fpm-systemd, the FPM master process calls the notify API once it is listening and ready, satisfying the Type=notify contract. After installing, run systemctl daemon-reload (in case unit files changed) and start the service normally. Startup should return immediately and the process should survive indefinitely.

On some setups you may also need to ensure the pkg-config files for systemd are available at build time, since the configure script checks for them; if --with-fpm-systemd silently has no effect, install the systemd development package and re-run configure.

The quick workaround: change the unit type

If rebuilding is not immediately practical, edit /usr/lib/systemd/system/php8.3-fpm.service and replace Type=notify with Type=simple. Under Type=simple, systemd considers the process started as soon as it forks, with no notification handshake required. Reload the unit afterward:

systemctl daemon-reload
systemctl restart php8.3-fpm

This works, but it is a workaround, not a repair. You lose systemd's ability to track true readiness and to accurately report service state, and the edited unit file will be overwritten the next time the packaged PHP is upgraded. Prefer the rebuild when you can.

Think carefully before building PHP from source

Getting the version number you want is often the motivation for a source build, but on Ubuntu the packaged version number understates what you actually get. The distribution backports security fixes into its packaged releases while keeping the original upstream version string, so an apt-installed PHP can contain patches that upstream released much later.

Switching to a self-built PHP also transfers the entire maintenance burden — security monitoring, rebuilding on every advisory, rebuilding dependent extensions, and regression testing — from the distribution to you. That work repeats for every update, forever. Unless you need a configuration or feature the packages cannot provide, staying on the packaged build is usually the lower-risk choice.

Frequently Asked Questions

Why does the site still work during those 90 seconds?

PHP-FPM starts and listens immediately; the timeout is about systemd's readiness check, not the daemon's ability to serve. When systemd's 90-second timer expires, it terminates the processes, and the site goes down at that point.

Where can I see the timeout message?

Run journalctl -xeu php8.3-fpm.service. A "start operation timed out. Terminating." entry is the signature of this problem, and the elapsed time will match your TimeoutStartSec value.

Does the PID file being present change anything?

No. With Type=notify, systemd ignores PID files as a readiness indicator. It only accepts the READY=1 notification from the process itself.

How do I check whether my FPM binary has systemd support?

Run php-fpm -i | grep -i systemd or inspect the configure options embedded in the build. If the binary was not configured with --with-fpm-systemd, it will not send readiness notifications.

Can I just increase TimeoutStartSec instead?

That only delays the inevitable. Without the notification, no timeout is long enough — the service will still be killed eventually. Fix the handshake or change the unit type.

Will changing the unit file break future updates?

Yes, potentially. Files under /usr/lib/systemd/system are package-owned and get replaced on upgrades. If you must edit, copy the unit to /etc/systemd/system and modify it there so your change takes precedence and survives package updates.

Latest News

How to Display Output of xterm Command in Terminal Screen using Cron

Resolve the inability to display xterm output in a terminal screen from cron by redirecting logs or using wall instead of insecure X11 workarounds.

Read More
Expose Local Server on VPS Preserving Real Client IPs (OS Level)

Resolve VPS logging showing only gateway IPs by configuring reverse proxies to forward real client addresses via X-Forwarded-For headers.

Read More
How to Clear Recent Files History in Linux without Deleting Actual Files?

Clear recent files history in Linux by deleting ~/.local/share/recently-used.xbel without removing the actual files.

Read More
Best HDD Copy Strategy: Manually Syncing and Rewriting Scratch

Resolve data drift between two 4TB hard drives by using rsync with the --delete flag to manually sync and rewrite scratch data for an exact mirror.

Read More
Understanding Bash Prompt Abbreviations: An Overview

Resolve repetitive typing errors by creating and persisting Bash aliases in the .bashrc file for improved command-line efficiency.

Read More
Free Tools and Methods to Log Real-Time Performance Details in Task Manager

Log real-time CPU and memory metrics to CSV files using Windows Performance Monitor Data Collector Sets to troubleshoot system slowness.

Read More
Contact Qatar Airways Customer Service: Phone Number, Help Center, and More

Resolve urgent Qatar Airways reservation issues like flight changes and baggage claims using the US phone number +1801-855-5905 or online self-service tools.

Read More
Windows 11: Alt Codes Displaying Wrong Characters - Solutions

Resolve Windows 11 Alt codes showing wrong characters by verifying the US keyboard layout and enabling Num Lock.

Read More
Run Programs with Elevated Privileges: A Comprehensive Guide

Eliminates the need to type sudo for frequent administrative tasks by configuring .bashrc aliases or functions.

Read More
Dynamically Changing Dates in Excel Formulas Using Cells

Eliminate manual date updates in Excel by using cell references to create dynamic formulas that automatically adjust calculations when input dates change.

Read More
Granting Edit Access to a Specific Excel Sheet in an Office 365 User Email ID-Based Login

Excel Online lacks native sheet-level permissions, so users must split workbooks or use worksheet protection to isolate edit access for specific tabs.

Read More
Creating Network Load on Local Wi-Fi from One PC

Generate sustained Wi-Fi bandwidth load from a single PC using a VM SFTP server to test router stability and throughput.

Read More
Changing the Default Editor for Batch Files in Windows 11's File Explorer

Resolve the issue of batch files opening in Notepad by changing the default editor to a preferred application like VS Code.

Read More
Gain WiFi Connection Minutes Before Losing it by Changing MAC Address

Bypass MAC address filtering to restore WiFi connectivity temporarily when a device is blocked by network administrators.

Read More
Photos Folders Turned Black: Troubleshooting Picture Applications on Windows

Resolve black screens in Windows Photos by resetting the app, updating graphics drivers, and repairing system files.

Read More
Troubleshooting High CPU Temperature Values: A Step-by-Step Guide

Resolve high CPU temperatures and thermal throttling by monitoring with Speedfan, cleaning dust from cooling components, and replacing degraded thermal paste.

Read More
Make cURL establish TLS connection with CA unknown

Resolve cURL TLS connection failures with unknown or self-signed certificates by using the --insecure flag to bypass CA validation.

Read More
Troubleshooting Incorrect Network Metrics Values in Grafana, Prometheus, InfluxDB, and Telegraf

Fix incorrect network metrics in Grafana, Prometheus, InfluxDB, and Telegraf by verifying interface selection, resolving unit mismatches, and handling counter resets.

Read More
Start Another Terminal Window (cmd.exe) Windows Repair/Troubleshoot

Provides step-by-step instructions to access the Windows Command Prompt via bootable media for advanced system repair and troubleshooting.

Read More
Thinkpad P1 Gen 6: Sudden Thunderbolt 3 Dock USB-C Charging Stopped Working

Resolve sudden Thunderbolt 3 dock USB-C charging and internet failure on ThinkPad P1 Gen 6 by updating firmware, resetting the dock, and adjusting power settings.

Read More
ASUS Windows 11 Laptop: Internet Connection Issue with Hotspot

Resolve ASUS Windows 11 laptop spinning wheel issue when connecting to mobile hotspot by resetting network stack, disabling IPv6, and adjusting power settings.

Read More
Developing iOS Project with Firebase: Logging in and Sending Push Notifications

Integrates Firebase to enable secure user authentication and push notifications in iOS applications.

Read More
Troubleshooting Bash Script with Suspected Issues of Spaces, Dashes, Filenames and Quoting

Resolve Bash script failures caused by word splitting, globbing, and special characters in filenames by applying proper quoting techniques.

Read More
Populating OneDrive Folder for Local Backup without Affecting Remote Files

Prevent OneDrive from deleting remote files during Windows reinstallation by unlinking the account or using symbolic links to isolate local data.

Read More
Force First Frame as Keyframe Without Re-encoding: A Quick Solution

Resolve inaccurate seeking and playback glitches by re-encoding video to ensure the first frame is a valid keyframe.

Read More
Find Information in Database Using WSL (Ubuntu) on Windows-10

Resolve database connection issues from WSL Ubuntu on Windows 10 by configuring client tools and network access to query remote or local servers.

Read More
Configuring a New Router with Different Networks: One Family, One Guest

Resolve IP conflicts and isolate guest traffic by configuring a second router with a distinct subnet via its WAN port.

Read More
Quickly Open Multiple Stock Websites with a Single Command

Solve the problem of manually opening multiple stock research websites by creating a single command to launch them simultaneously on Windows, macOS, or Linux.

Read More
Improved Adobe Acrobat Search Experience: Access Advanced Search with Ease

Access advanced search filters like case sensitivity and regex in Adobe Acrobat by clicking More Options in the Find bar.

Read More
Port Forwarding VM via OpenVPN: A Comprehensive Guide

Configure OpenVPN server and iptables to forward specific ports from VPN clients to a virtual machine's internal IP address.

Read More
Understanding Partitions in the 1980s: A Look Back at MS-DOS and Master Boot Record

Explains how the Master Boot Record and partition table enabled MS-DOS to manage multiple disk volumes on a single physical drive.

Read More
Windows 10 Enterprise: Keyboard Not Detected in Managed Organization with Admin Privileges

Resolve Windows 10 Enterprise keyboard detection failures caused by Group Policy restrictions, driver corruption, or USB enumeration errors.

Read More
Can't Find x86_64 Versions of Applications on MacOS arm64 (M1)

Resolve missing x86_64 app issues on M1 Macs by installing Rosetta 2 and reinstalling apps as universal binaries.

Read More
How to Hide Installation Source for an Android App

Manage Android app installation source visibility by using USB transfers or file managers to reduce browser traces and isolate data via work profiles.

Read More
Connecting Momentus 4200.2 ST9808210A Hard Drive via USB Cable

Resolve inability to access Seagate Momentus 4200.2 ST9808210A hard drive by connecting it via USB using a compatible SATA-to-USB adapter and configuring the disk in Windows.

Read More