PHPackages stumason/laravel-coolify - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Logging & Monitoring](/categories/logging) 4. / 5. stumason/laravel-coolify ActiveLibrary[Logging & Monitoring](/categories/logging) stumason/laravel-coolify ======================== Manage, deploy, and monitor your Laravel application on Coolify - like Horizon for your infrastructure. v3.3.0(1mo ago)52.7k↑16.7%[2 issues](https://github.com/StuMason/laravel-coolify/issues)MITPHPPHP ^8.2CI passing Since Dec 17Pushed 1mo agoCompare [ Source](https://github.com/StuMason/laravel-coolify)[ Packagist](https://packagist.org/packages/stumason/laravel-coolify)[ RSS](/packages/stumason-laravel-coolify/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (5)Dependencies (22)Versions (62)Used By (0) Laravel Coolify =============== [](#laravel-coolify) [![Tests](https://github.com/StuMason/laravel-coolify/actions/workflows/tests.yml/badge.svg)](https://github.com/StuMason/laravel-coolify/actions/workflows/tests.yml)[![Latest Version](https://camo.githubusercontent.com/878bd63eb26d70eeaa42e287e1335199d7a5d2bd5665595458dd50efcf632181/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7374756d61736f6e2f6c61726176656c2d636f6f6c6966792e737667)](https://packagist.org/packages/stumason/laravel-coolify)[![PHP Version](https://camo.githubusercontent.com/fc0a49a74d8a173fc516c41ae58b6d443ca1bffc0b14d039835687b1a53b299f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f7374756d61736f6e2f6c61726176656c2d636f6f6c6966792e737667)](https://packagist.org/packages/stumason/laravel-coolify)[![Laravel Version](https://camo.githubusercontent.com/ccb0953d3a08f2c992ee5bae1cbb03ebd101923f2401346e1b8a551b5197a41f/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c61726176656c2d31312e7825323025374325323031322e782d7265642e737667)](https://laravel.com)[![License](https://camo.githubusercontent.com/69862753dd2b62bff8388225d63a9c1d973b9ef0ec48e84e11c937dae58bf442/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f7374756d61736f6e2f6c61726176656c2d636f6f6c6966792e737667)](LICENSE)[![Downloads](https://camo.githubusercontent.com/5106c5f81b8aebc80c2575fb8bb0dc87ffb79fcaef41ebc1d32887f9540e8d88/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f7374756d61736f6e2f6c61726176656c2d636f6f6c6966792e737667)](https://packagist.org/packages/stumason/laravel-coolify) **Deploy Laravel to [Coolify](https://coolify.io) with one command. Dashboard, CLI, and Dockerfile generation included.** Like Laravel Horizon for queues, but for your entire infrastructure. [![Laravel Coolify Dashboard](docs/dashboard.png)](docs/dashboard.png) Why This Exists --------------- [](#why-this-exists) Self-hosting with Coolify is great, but managing deployments from the Coolify UI gets tedious. This package gives you: - **A beautiful dashboard** inside your Laravel app - deploy, restart, view logs, manage env vars - **Artisan commands** for everything - CI/CD pipelines, local development, scripting - **Production-ready Dockerfiles** generated automatically - no Docker knowledge required - **Full API access** to Coolify - build custom tooling, automations, whatever you need Quick Start ----------- [](#quick-start) ``` composer require stumason/laravel-coolify php artisan coolify:install ``` Add to `.env`: ``` COOLIFY_URL=https://your-coolify.com COOLIFY_TOKEN=your-api-token ``` Then provision your infrastructure: ``` php artisan coolify:provision ``` This creates app + PostgreSQL + Dragonfly on Coolify and deploys. The provision command automatically adds `COOLIFY_PROJECT_UUID` to your `.env` file, enabling all other commands to work without manual configuration. Documentation ------------- [](#documentation) **[Read the full docs](https://stumason.github.io/laravel-coolify)** Dashboard Features ------------------ [](#dashboard-features) Access at `/coolify` (configurable) - works like Horizon's dashboard. FeatureDescription**Live Status**Real-time application health with animated indicators**One-Click Deploy**Deploy latest, force rebuild, or deploy specific commits**Deployment History**View all deployments with inline expandable build logs**Database Management**Start/stop/restart PostgreSQL, MySQL, Redis, Dragonfly**Environment Variables**Secure CRUD for env vars with masked values**Build Logs**Stream deployment logs in real-time**GitHub Integration**Links to commits, branches, repository**Coolify Deep Links**Jump directly to resources in Coolify UI### Dashboard Screenshots [](#dashboard-screenshots) The dashboard shows everything at a glance: - Application status with health checks - Current branch, commit, and last deploy time - Database and cache status with connection strings - Recent deployments with inline build logs - Quick actions for deploy, restart, stop ### Laravel Kick Integration [](#laravel-kick-integration) Install [laravel-kick](https://github.com/StuMason/laravel-kick) on your deployed app for enhanced introspection: ``` # On your deployed app composer require stumason/laravel-kick ``` Add to the app's Coolify environment: ``` KICK_ENABLED=true KICK_TOKEN=your-secure-token ``` A new **Kick** tab appears with: - Health checks (database, cache, storage, redis) - System stats (CPU, memory, disk, uptime) - Log viewer with filtering and search - Queue status and failed jobs - Artisan command execution Artisan Commands ---------------- [](#artisan-commands) CommandDescription`coolify:install`Publish config, generate Dockerfile`coolify:provision`Create infrastructure on Coolify`coolify:deploy`Trigger deployment`coolify:status`Show application status`coolify:logs`View application logs`coolify:restart`Restart application`coolify:rollback`Rollback to previous deployment### CI/CD Integration [](#cicd-integration) ``` # .github/workflows/deploy.yml - name: Deploy to Coolify run: php artisan coolify:deploy --force env: COOLIFY_URL: ${{ secrets.COOLIFY_URL }} COOLIFY_TOKEN: ${{ secrets.COOLIFY_TOKEN }} ``` Dockerfile Generation --------------------- [](#dockerfile-generation) The install command generates production-optimized Docker configuration: ``` php artisan coolify:install ``` Creates: - `Dockerfile` - Multi-stage build with OPcache, proper permissions - `docker/nginx.conf` - Optimized for Laravel - `docker/supervisord.conf` - Process management (Horizon, Reverb, Scheduler auto-detected) - `docker/php.ini` - Production PHP settings Auto-detects and configures: - Laravel Horizon (queue workers) - Laravel Reverb (WebSockets) - Laravel Scheduler Programmatic API ---------------- [](#programmatic-api) ``` use Stumason\Coolify\Coolify; // Deploy Coolify::deploy(); Coolify::deploy('custom-uuid'); // Status $status = Coolify::status(); $logs = Coolify::logs(); // Repositories for full control Coolify::applications()->get($uuid); Coolify::applications()->deploy($uuid, force: true); Coolify::applications()->restart($uuid); Coolify::applications()->envs($uuid); Coolify::databases()->all(); Coolify::databases()->start($uuid); Coolify::deployments()->forApplication($uuid); Coolify::deployments()->cancel($uuid); Coolify::servers()->all(); Coolify::services()->all(); ``` Configuration ------------- [](#configuration) After running `coolify:provision`, your `.env` will contain: ``` COOLIFY_URL=https://your-coolify.com COOLIFY_TOKEN=your-api-token COOLIFY_PROJECT_UUID=your-project-uuid # Added automatically by provision ``` The dashboard automatically fetches your application and resources from the configured project's environment. No need to manually configure application UUIDs. ``` // config/coolify.php return [ 'url' => env('COOLIFY_URL'), 'token' => env('COOLIFY_TOKEN'), 'project_uuid' => env('COOLIFY_PROJECT_UUID'), // Set by coolify:provision 'path' => env('COOLIFY_PATH', 'coolify'), 'docker' => [ 'php_version' => '8.4', 'use_base_image' => true, // Fast builds with pre-built images ], ]; ``` Authentication -------------- [](#authentication) By default, the dashboard is only accessible in `local` environment. For production: ``` // app/Providers/AppServiceProvider.php use Stumason\Coolify\Coolify; public function boot(): void { Coolify::auth(function ($request) { return $request->user()?->isAdmin(); }); } ``` Requirements ------------ [](#requirements) - PHP 8.2+ - Laravel 11 or 12 - Coolify 4.x instance with API access Testing ------- [](#testing) ``` composer test # Run tests composer test:coverage # With coverage composer lint # Static analysis ``` Contributing ------------ [](#contributing) Contributions welcome! Please read [CONTRIBUTING.md](CONTRIBUTING.md) first. License ------- [](#license) MIT - see [LICENSE](LICENSE) Credits ------- [](#credits) - [Stu Mason](https://github.com/StuMason) - [All Contributors](../../contributors) ### Health Score 48 — FairBetter than 95% of packages Maintenance82 Actively maintained with recent releases Popularity27 Limited adoption so far Community8 Small or concentrated contributor base Maturity61 Established project with proven stability Bus Factor1 Top contributor holds 82.4% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~3 days Recently: every ~16 days Total 38 Last Release 54d ago Major Versions v0.9.10 → v1.0.02026-01-06 v1.0.1 → v2.0.02026-01-06 v2.9.0 → v3.0.02026-01-19 ### Community Maintainers ![](https://www.gravatar.com/avatar/81944ec9cc7c6d5f0380f888fd5e34f1481dbba5bfdd5af01809529aad5762b4?d=identicon)[StuMason](/maintainers/StuMason) --- Top Contributors [![StuMason](https://avatars.githubusercontent.com/u/21249318?v=4)](https://github.com/StuMason "StuMason (108 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (23 commits)") --- Tags coolifydeploymentdevopsdockerlaravelpaasphpself-hostedlaravelmonitoringdevopsdeploymentinfrastructurecoolify ### Code Quality TestsPest Static AnalysisPHPStan Code StyleLaravel Pint Type Coverage Yes ### Embed Badge ![Health badge](/badges/stumason-laravel-coolify/health.svg) ``` [![Health](https://phpackages.com/badges/stumason-laravel-coolify/health.svg)](https://phpackages.com/packages/stumason-laravel-coolify) ``` ### Alternatives [spatie/laravel-health Monitor the health of a Laravel application 86910.0M83](/packages/spatie-laravel-health)[roots/acorn Framework for Roots WordPress projects built with Laravel components. 9682.1M97](/packages/roots-acorn)[yadahan/laravel-authentication-log Laravel Authentication Log provides authentication logger and notification for Laravel. 416632.8k5](/packages/yadahan-laravel-authentication-log)[inspector-apm/inspector-laravel Code Execution Monitoring, built for developers. 2332.0M2](/packages/inspector-apm-inspector-laravel)[aedart/athenaeum Athenaeum is a mono repository; a collection of various PHP packages 245.2k](/packages/aedart-athenaeum) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)