FrankenPHP (Octane)

Laravel Octane variant powered by FrankenPHP. The container keeps a long-running PHP worker pool warm, eliminating per-request boot overhead.

Image tags

Tag	PHP
ghcr.io/jonaaix/laravel-aio:1.3-php8.5-frankenphp	8.5
ghcr.io/jonaaix/laravel-aio:1.3-php8.4-frankenphp	8.4

First-time switch

When switching to a Laravel Octane based image for the first time, the entrypoint will automatically install laravel/octane and run octane:install --server=frankenphp if not already configured. You can commit the changes to your repository.

Workers

Octane workers default to 2 × nproc (CPU cores × 2). Override via the OCTANE_WORKERS env var if needed.

Configuration

All shared env vars apply — see Configuration. Octane-specific behavior:

• OCTANE_SERVER (in .env or config/octane.php) must match PHP_RUNTIME_CONFIG=frankenphp — the entrypoint validates consistency on boot and exits with an error on mismatch.
• Octane's supervisor worker config is auto-added when a non-FPM runtime is detected.

See Quick start for a minimal compose snippet.