Install FrankenPHP on Linux

Table of Contents

TL;DR #

wget -q -O- 'https://gorbe.io/posts/frankenphp/install/script.sh' | bash -x -

Download binary #

Download the latest binary from GitHub Releases: https://github.com/dunglas/frankenphp/releases

wget -q "https://github.com/dunglas/frankenphp/releases/download/$(wget -q -O- 'https://api.github.com/repos/dunglas/frankenphp/releases/latest' | jq -r '.tag_name')/frankenphp-linux-$(uname -m)"

Install the binary #

Use the install command to copy the binary to /usr/bin/ and set attributes:

sudo install -v "frankenphp-linux-$(uname -m)" /usr/bin/frankenphp

Create user and group #

Create the group first:

sudo groupadd --system frankenphp

Create the frankenphp user:

sudo useradd --system --gid frankenphp --create-home  --home-dir /var/lib/frankenphp --shell /usr/sbin/nologin frankenphp

Create Caddyfile #

Create the directory for the Caddyfile:

mkdir /etc/frankenphp

Now, create the Caddyfile:

echo -e "{\n}" > /etc/frankenphp/Caddyfile

Change the user and group of the config directory:

chown -R frankenphp:frankenphp /etc/frankenphp/

Configure systemd #

Create the systemd service:

nano /etc/systemd/system/frankenphp.service

[Unit]
Description=FrankenPHP Server
After=network.target network-online.target
Requires=network-online.target

[Service]
Type=notify
User=frankenphp
Group=frankenphp
ExecStartPre=/usr/bin/frankenphp validate --config /etc/frankenphp/Caddyfile
ExecStart=/usr/bin/frankenphp run --environ --config /etc/frankenphp/Caddyfile
ExecReload=/usr/bin/frankenphp reload --config /etc/frankenphp/Caddyfile --force
TimeoutStopSec=5s
LimitNOFILE=1048576
PrivateTmp=true
ProtectSystem=full
AmbientCapabilities=CAP_NET_ADMIN CAP_NET_BIND_SERVICE

[Install]
WantedBy=multi-user.target

Reload systemd to load the new service:

sudo systemctl daemon-reload

Enable the service to start at boot:

sudo systemctl enable --now frankenphp