Download the PHP package vanaboom/laravel-toolbox without Composer

Laravel Toolbox

A development toolkit for Laravel applications with built-in Docker scaffolding, Supervisor configurations, and optional services like Horizon, Echo Server, and Scheduler.

Features

• Laravel Octane ready with RoadRunner by default and optional FrankenPHP support
• Preconfigured Supervisor process management
• Optional service configs for Horizon, Echo Server, Scheduler
• Environment-based starter mode (dev or prod)
• Ready-to-publish Docker scaffold for rapid project setup
• Works seamlessly with the public base image vanaboom/laravel-boomkit

Installation

Or, for the first-time setup with Docker (without Composer installed locally):

Replace alpine with your BUILD_TAG, or use alpine-frankenphp together with OCTANE_SERVER=frankenphp.

Configuration

Publish the configuration file:

The config file will be published to config/toolbox.php.

Key options:

• mode → dev or prod
• verbose_mode → Enable verbose logging for starter command
• octane_watch → Whether to enable Octane file watching in dev mode

Docker Scaffold

Publish a ready-to-use Docker scaffold into your Laravel app:

The scaffold includes:

• Dockerfile using vanaboom/laravel-boomkit:${BOOMKIT_VERSION}-${BUILD_TAG}

• Supervisor configs:

  • starter → Runs php artisan toolbox:starter
  • Optional: horizon, echo-server, scheduler (copy from .ini.example to enable)
• Configurable environment variables for user/group IDs, app directory, custom commands, Octane runtime, Docker registry mirror, and more

To avoid Composer re-running on every container start, add stamp files to your .gitignore:

Example docker-compose service

Octane Runtime

RoadRunner remains the default runtime for backward compatibility. To use FrankenPHP, build with the Boomkit FrankenPHP tag and set the Octane server explicitly:

For registries or Docker Hub mirrors, set DOCKER_REGISTRY to the mirror prefix used by your environment.

Healthcheck Route

Add this to your routes/web.php to make the Docker healthcheck work:

Supervisor

The scaffold comes with /etc/supervisor.d containing process configs.

Starter

Runs the Laravel Toolbox starter command based on environment:

Horizon (optional)

Copy horizon.ini.example to horizon.ini to enable:

Echo Server (optional)

Copy echo-server.ini.example to echo-server.ini to enable:

Scheduler (optional)

Copy scheduler.ini.example to scheduler.ini to enable:

License

This package is open-sourced software licensed under the MIT license.