stumason/laravel-coolify-starter

Transform a fresh Laravel app into a production-ready Coolify deployment with Horizon, Reverb, Telescope, and health checks.

v1.2.0 2025-12-18 10:41 UTC

Requires

• php: ^8.2
• illuminate/console: ^11.0|^12.0
• illuminate/support: ^11.0|^12.0

Requires (Dev)

• laravel/pint: ^1.18
• orchestra/testbench: ^9.0|^10.0
• pestphp/pest: ^3.0
• phpstan/phpstan: ^2.0

MIT

• Stu Mason

• laravel
• deployment
• horizon
• telescope
• reverb
• coolify
• nixpacks

README

Sets up a fresh Laravel app for Coolify deployment.

What this does

Runs php artisan coolify:install which:

• Installs Horizon, Reverb, Telescope, Sanctum (you pick which ones)
• Installs stumason/laravel-coolify for the deployment dashboard
• Publishes nixpacks.toml for Coolify builds
• Adds a /health endpoint
• Switches .env to Postgres and Redis
• Adds a composer run dev script that runs everything concurrently
• Publishes coding standards docs to docs/standards/

If you have COOLIFY_URL and COOLIFY_TOKEN in your .env, it offers to run coolify:provision to create the app on Coolify.

COOLIFY_URL=https://app.coolify.io
COOLIFY_TOKEN=your-api-token

The token needs to be a root-level API token (created by a Coolify admin under Keys & Tokens > API Tokens).

Requirements

• PHP 8.2+
• Laravel 11 or 12
• Fresh Laravel install

Installation

composer require stumason/laravel-coolify-starter --dev
php artisan coolify:install

Answer the prompts or use flags:

php artisan coolify:install --all                    # Install everything
php artisan coolify:install --horizon --telescope    # Pick specific packages
php artisan coolify:install --no-interaction         # Skip prompts
php artisan coolify:install --force                  # Overwrite existing files

After installation

createdb your_project_name
php artisan migrate
composer run dev

Files published

nixpacks.toml
app/Http/Controllers/HealthCheckController.php
resources/js/pages/health-check.tsx
app/Providers/HorizonServiceProvider.php      (if Horizon)
app/Providers/TelescopeServiceProvider.php    (if Telescope)
docs/standards/
.prettierrc
.prettierignore
.editorconfig
eslint.config.js

.env changes

DB_CONNECTION=pgsql
DB_DATABASE=your_project_name
SESSION_DRIVER=redis
CACHE_STORE=redis
QUEUE_CONNECTION=redis

License

MIT