Skip to content

Ports and file paths

Port Protocol Exposed Used by
80 TCP yes HTTP → HTTPS, ACME HTTP-01
443 TCP + UDP (HTTP/3) yes Panel, API, webhooks, installer, agent API (agents. host, mTLS), Grafana, OTLP ingest (/otlp)

Other ports stay inside the Compose network (Postgres 5432, Valkey 6379, Reverb 8080, the terminal relay 8080 in its own container, Grafana 3000, Loki 3100, Tempo 3200, gateway 9090). Change the public ports only for testing (--http-port/--https-port with --tls internal).

Path Contents
/opt/falak/.env Settings and secrets (mode 600)
/opt/falak/secrets/kek Key-encryption key (mode 0400); kek.previous after a rotation
/opt/falak/dr/dr.env DR bucket and passphrase (root only)
/opt/falak/state/dr.json DR status read by the panel (no secrets)
/opt/falak/custom.env Optional extra settings
/opt/falak/deploy/ compose.yml, falak-ctl, support files (previous version kept as deploy.prev)
/opt/falak/observability/ Loki, Tempo, gateway and Grafana configuration
/opt/falak/backups/ falak-ctl backup output (mode 700)
/usr/local/bin/falak-ctl The operations tool
falak-backup.timer, falak-drill.timer Scheduled backups and drills (falak-ctl dr setup)

pg-data, valkey-data, app-storage (artifacts, app files), falak-ca (Fleet CA certificate), edge-pki, caddy-data (ACME certificates), caddy-config, builder-data, builder-cache, and with observability loki-data, tempo-data, vm-data, grafana-data.

Port Listens on Opened by default Purpose
22 all yes (always accepted) SSH
80, 443 all app, web, lb servers Caddy / FrankenPHP
4318 127.0.0.1 no OTLP/HTTP receiver of the agent
3000–3999 127.0.0.1 no App ports of Node, Bun, Deno and Docker sites (blue/green: +1000)
8000–8999 127.0.0.1 (FrankenPHP Octane: all interfaces) no Laravel Octane ports; auxiliary port = +10000
20000–29999 127.0.0.1; a private address for other servers of the environment; all interfaces with public access no (filtered per consumer) Database containers’ host ports
51820/udp all on private network members WireGuard (default)

Compose public services are published on 127.0.0.1:<allocated port>.

Path Contents
/usr/local/bin/falak-agent Agent binary (.prev: previous version after an upgrade)
/etc/systemd/system/falak-agent.service Agent unit
/etc/falak/ agent.key, agent.crt, ca.crt, agent.json, telemetry.json, certs/, optional agent.env
/var/lib/falak/ Process and cron state, OTLP disk buffer; protection.json (IP blocks and auto-bans to restore after a reboot); captures/ (packet captures while they upload, removed afterwards)
/etc/falak/net.json, /etc/falak/ebpf.json Network collector settings; the eBPF setting and an over-budget stop
/var/log/falak/fpm-<pool>.log, /var/log/falak/php-fpm-slow/<pool>.log PHP-FPM error log of a site’s own master; PHP-FPM slow-request logs
/run/falak/otlp.sock OTLP socket for apps
/var/log/falak/ Supervised program logs
/var/log/falak/access/<site>.log Caddy access logs (JSON, 10 MB × 3)
/srv/falak/sites/<site>/releases/<RELEASE_ID>/ Releases
/srv/falak/sites/<site>/shared/ storage/ and other shared paths; .env is a symlink to /run/falak/env/
/run/falak/env/<site>.env Site environment files (tmpfs)
/run/falak-edge/admin.sock Caddy admin API (root-only unix socket)
/var/lib/falak/volumes/<id> Sized volumes (loop-mounted ext4 images)
/srv/falak/sites/<site>/current Symlink to the live release
/home/falak The falak user’s home