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.