Instalasi SSL pada FrankenPHP untuk CodeIgniter

Hai semuanya, apa kabar? Kali ini aku mau sharing pengalamanku instal SSL di klien. Biasanya yang aku handle itu instalasi SSL di Zimbra atau web server seperti Apache atau Nginx. Kali ini aku ada pekerjaan instalasi SSL web app tapi alih-alih menggunakan Apache (yang aku lebih familiar), pas dicek ternyata pakai Caddy web server. Hmm baru tau kali ini kayanya. Kali ini aku mau tulis juga di blog, tentunya gak pakai detail informasi klien yang aku tangani.

Pertama, aku gak langsung tau kalo server-nya pakai Caddy/FrankenPHP. Aku kira Apache/Nginx bias. Untuk ceknya, kita bisa pakai perintah ini:

grep -rn "app-ci4" /etc/nginx/ 2>/dev/null
grep -rn "app-ci4" /etc/apache2/ /etc/httpd/ 2>/dev/null

Kalau hasil/output-nya kosong, berarti web server yang dimaksud kemungkinan besar bukan Apache/Nginx.

Pengecekan selanjutnya adalah mengecek port & services yang sedang digunakan, bisa menggunakan perintah berikut:

ss -tulpn

contoh output:
 Netid  State   Recv-Q  Send-Q   Local Address:Port    Peer Address:Port  Process
tcp    LISTEN  0       128            0.0.0.0:22            0.0.0.0:*      users:(("sshd",pid=617,fd=6))
tcp    LISTEN  0       4096         127.0.0.1:2019          0.0.0.0:*      users:(("frankenphp",pid=2572,fd=3))
tcp    LISTEN  0       4096                 *:80                  *:*      users:(("frankenphp",pid=2572,fd=6))

FrankenPHP menggunakan port 80 (dan port admin 2019). Untuk cek lokasi file konfigurasi FrankenPHP bisa dicek terlebih dahulu detail prosesnya.

ps aux | grep frankenphp
systemctl status frankenphp --no-pager

contoh output:
franken+    2572  0.0  4.5 2754144 180816 ?      Ssl  Nov18   0:10 /usr/bin/frankenphp run --environ --config /etc/frankenphp/Caddyfile

● frankenphp.service - FrankenPHP - The modern PHP app server
     Loaded: loaded (/usr/lib/systemd/system/frankenphp.service; enabled; preset: enabled)
     Active: active (running) since Wed 2026-11-18 17:06:40 WIB; 18h ago
    Process: 2564 ExecStartPre=/usr/bin/frankenphp validate --config /etc/frankenphp/Caddyfile (code=exited, status=0/SUCCESS)
   Main PID: 2572 (frankenphp)

Dari contoh output di atas, file konfigurasinya ada di /etc/frankenphp/Caddyfile

Siapkan File SSL
File yang perlu disiapkan formatnya adalah .crt & .key, bukan .pfx seperti di Windows:

  • Sertifikat utama domain (ssl.crt).
  • Private key (commercial.key).
  • CA bundle (ca_bundle.crt).

Sebelum dipasang, pastikan ketiga file tersebut match. Contoh pengecekannya:

openssl x509 -in ssl.crt -noout -subject -dates 
openssl x509 -noout -modulus -in ssl.crt | openssl md5 
openssl rsa -noout -modulus -in commercial.key | openssl md5

Apabila ketiga file tersebut sudah match, gabungkan file ssl.crt & ca_bundle.crt menjadi fullchain.crt ke direktori /etc/ssl/custom-app. Bisa menggunakan perintha berikut:

mkdir -p /etc/ssl/custom-app
awk 1 ssl.crt ca_bundle.crt > /etc/ssl/custom-app/fullchain.crt
cp commercial.key /etc/ssl/custom-app/privkey.key

# Atur kepemilikan & hak akses agar bisa dibaca oleh user 'frankenphp'
chown -R root:frankenphp /etc/ssl/custom-app
chmod 750 /etc/ssl/custom-app
chmod 644 /etc/ssl/custom-app/fullchain.crt
chmod 640 /etc/ssl/custom-app/privkey.key

Konfigurasi HTTPS di Caddyfile
Kita bisa ganti blok :80 yang ada di Caddyfile dengan nama domain asli kita, dan tambahkan parameter yang mengarahkan ke fullchain.crt & privkey.key. ecara otomatis, Caddy akan membuka port 443 (termasuk dukungan HTTP/2 dan HTTP/3) sekaligus mengalihkan akses HTTP port 80 ke HTTPS. Jangan lupa backup file konfigurasi awal.

cp /etc/frankenphp/Caddyfile /etc/frankenphp/Caddyfile.bak

Lalu sesuaikan isi file Caddyfile, contohnya adalah di bawah ini:

{
    frankenphp {
        num_threads 8

        worker {
            file /var/www/app-ci4/public/frankenphp-worker.php
            num 4
            max_consecutive_failures 10
        }

        php_ini memory_limit 512M
        php_ini max_execution_time 300
        php_ini max_input_time 60
        php_ini max_file_uploads 20
        php_ini upload_max_filesize 40M
        php_ini post_max_size 50M
    }

    order php_server before file_server
}
#mulai di bawah ini, yang atas biarkan saja
apps.example.co.id {
    tls /etc/ssl/custom-app/fullchain.crt /etc/ssl/custom-app/privkey.key

    root * /var/www/app-ci4/public

    encode zstd br gzip

    php_server
}

Selain Caddyfile, sesuaikan juga app.baseURL di dalam file .env milik CodeIgniter 4 yang sebelumnya masih mengarah ke IP lokal.

grep -E "app\.baseURL" /var/www/app-ci4/.env

contoh yang diedit:
app.baseURL = 'https://apps.example.co.id/'

Validasi & restart layanan

Validasi: frankenphp validate --config /etc/frankenphp/Caddyfile
Contoh output:

2026/11/19 04:53:51.083 INFO    using config from file  {"file": "/etc/frankenphp/Caddyfile"}
2026/11/19 04:53:51.086 INFO    adapted config to JSON  {"adapter": "caddyfile"}
2026/11/19 04:53:53.337 WARN    tls     stapling OCSP   {"error": "no OCSP stapling for [apps.example.co.id]: parsing OCSP response: ocsp: error from server: unauthorized"}
2026/11/19 04:53:53.338 INFO    http.auto_https skipping automatic certificate management because one or more matching certificates are already loaded  {"domain": "apps.example.co.id", "server_name": "srv0"}
2026/11/19 04:53:53.338 INFO    http.auto_https enabling automatic HTTP->HTTPS redirects        {"server_name": "srv0"}
2026/11/19 04:53:53.339 INFO    http    servers shutting down with eternal grace period
Valid configuration

Mulai ulang service

systemctl restart frankenphp
ss -tulpn | grep -E ":80|:443"

contoh output:
udp   UNCONN 0      0                   *:443             *:*    users:(("frankenphp",pid=3478,fd=14))
tcp   LISTEN 0      4096                *:80              *:*    users:(("frankenphp",pid=3478,fd=11))
tcp   LISTEN 0      4096                *:443             *:*    users:(("frankenphp",pid=3478,fd=12))

Testing lokal
Misalnya ini adalah case migrasi server dan DNS-nya masih mengarah ke server lama, tambahkan IP server ini ke file hosts di lokal. Lanjut tes:

curl -I --resolve apps.example.co.id:443:127.0.0.1 https://apps.example.co.id/

contoh output:
HTTP/2 200
alt-svc: h3=":443"; ma=2592000
cache-control: no-store, max-age=0, no-cache
content-type: text/html; charset=UTF-8
server: FrankenPHP Caddy
x-powered-by: PHP/8.5.12

Cek lokal juga bisa lewat web browser.

Tulisan kali ini sampai di sini dulu ya. Sampai jumpa. Bye.

By Zaidan

Leave a Reply

Your email address will not be published. Required fields are marked *