PHPackages                             m1n64/laravel-12-docker-startup - 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. [Framework](/categories/framework)
4. /
5. m1n64/laravel-12-docker-startup

ActiveProject[Framework](/categories/framework)

m1n64/laravel-12-docker-startup
===============================

The skeleton application for the Laravel framework.

v1.0.6(1y ago)13816[1 issues](https://github.com/m1n64/laravel-12-docker-startup/issues)[1 PRs](https://github.com/m1n64/laravel-12-docker-startup/pulls)MITPHPPHP ^8.2

Since Feb 27Pushed 1y ago2 watchersCompare

[ Source](https://github.com/m1n64/laravel-12-docker-startup)[ Packagist](https://packagist.org/packages/m1n64/laravel-12-docker-startup)[ RSS](/packages/m1n64-laravel-12-docker-startup/feed)WikiDiscussions main Synced today

READMEChangelog (7)Dependencies (14)Versions (9)Used By (0)

🚀 Laravel 12 Docker Startup
===========================

[](#-laravel-12-docker-startup)

This is a **Docker-based template** for **Laravel 12**, built with:

- **PHP 8.4** (FPM on Alpine)
- **PostgreSQL 16**
- **Redis (Alpine)**
- **Node.js 22 + NPM**
- **Supervisor for Queue &amp; Scheduler**
- **Makefile for easy commands (like Laravel Sail)**
- **Nginx**
- **Composer**
- **XDebug in Dev Mode**

And useful **libraries**:

- **[Telescope](https://laravel.com/docs/12.x/telescope)**
- **[Horizon](https://laravel.com/docs/11.x/horizon)**
- **[Log Viewer](https://log-viewer.opcodes.io/docs/3.x/install)**
- **[Scramble DeDoc](https://scramble.dedoc.co/installation)**

---

**🛠 Setup Instructions**
------------------------

[](#-setup-instructions)

### 1️⃣ Clone the Repository

[](#1️⃣-clone-the-repository)

```
composer create-project m1n64/laravel-12-docker-startup laravel-12-docker
cd laravel-12-docker
```

### 2️⃣ Copy `.env` and Update Configuration

[](#2️⃣-copy-env-and-update-configuration)

```
cp .env.example .env
```

- Open `.env` file and change it:

```
DB_DATABASE= # Change DB name
```

- Change the container name prefix:

    Inside `docker-compose.yml`, rename `l12-` to your project name:

```
services:
    app:
        container_name: myproject-app
    nginx:
        container_name: myproject-nginx
    postgres:
        container_name: myproject-postgres
    redis:
        container_name: myproject-redis
```

- Change the Docker network

    In `docker-compose.yml`:

```
networks:
   myproject-network:
```

---

🚀 Start Containers
------------------

[](#-start-containers)

### 🔹 Using Docker

[](#-using-docker)

```
docker-compose up -d
```

### 🔹 Using Makefile

[](#-using-makefile)

```
make up    # For development
make prod  # For production
```

---

📦 Install Dependencies
----------------------

[](#-install-dependencies)

### 🛠 Install PHP Dependencies

[](#-install-php-dependencies)

Run inside the container:

```
docker-compose exec -u www-data app composer install
```

Or using Makefile:

```
make composer install
```

### 🎸 Install Node.js &amp; NPM Dependencies

[](#-install-nodejs--npm-dependencies)

```
make npm install
make npm run dev   # Run Vite for development
```

### 🔑 Generate App Key

[](#-generate-app-key)

```
make artisan key:generate
```

### 📜 Run Migrations

[](#-run-migrations)

```
make artisan migrate
```

### 🔗 Create Storage Symlink

[](#-create-storage-symlink)

```
make artisan storage:link
```

---

💻 Available Commands
--------------------

[](#-available-commands)

### 🛠 Running Laravel Commands

[](#-running-laravel-commands)

ActionDocker CommandMakefile ShortcutRun `php artisan``docker-compose exec -u www-data app php artisan ``make artisan `Run `composer``docker-compose exec -u www-data app composer ``make composer `Run `npm``docker-compose exec -u www-data app npm ``make npm `Open Bash`docker-compose exec -u www-data app bash``make bash`View Logs`docker-compose logs -f app``make logs app`Open PostgreSQL CLI`docker-compose exec -e PGPASSWORD= postgres psql -U  -d ``make psql`Open Redis CLI`docker-compose exec redis redis-cli``make redis`Run Tests`docker-compose exec -u www-data app php artisan test``make test`---

🛑 Managing Containers
---------------------

[](#-managing-containers)

### 🔄 Restart &amp; Stop

[](#-restart--stop)

ActionDocker CommandMakefile ShortcutRestart all`docker-compose restart``make restart`Restart one`docker-compose restart ``make restart-container CONTAINER=`Stop all`docker-compose stop``make stop`Stop one`docker-compose stop ``make stop-container CONTAINER=`Start all`docker-compose up -d``make up`Remove all`docker-compose down -v``make down`For list of **all makefile commands**, run `make help`.

---

**💡 PHPStorm Setup**
--------------------

[](#-phpstorm-setup)

### PHP Interpreter

[](#php-interpreter)

[![image](https://private-user-images.githubusercontent.com/24874264/425226668-c19edc0a-e5ce-4905-8324-be4c7adbdbc1.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODI3MzQ0MTYsIm5iZiI6MTc4MjczNDExNiwicGF0aCI6Ii8yNDg3NDI2NC80MjUyMjY2NjgtYzE5ZWRjMGEtZTVjZS00OTA1LTgzMjQtYmU0YzdhZGJkYmMxLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA2MjklMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNjI5VDExNTUxNlomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTc4NmU5MmE3ZDE4NTFjOWEzZGE2NDU4MWUxNGY2MDFmZjAxYTkwNzc1MGI0NTg3ZTc0YWIwZDJmYWFlZjFiZGImWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JnJlc3BvbnNlLWNvbnRlbnQtdHlwZT1pbWFnZSUyRnBuZyJ9.UAvLKyqgM9O4eJSsydn7ObBIHYg1r_PuUC3YvWDZpUs)](https://private-user-images.githubusercontent.com/24874264/425226668-c19edc0a-e5ce-4905-8324-be4c7adbdbc1.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODI3MzQ0MTYsIm5iZiI6MTc4MjczNDExNiwicGF0aCI6Ii8yNDg3NDI2NC80MjUyMjY2NjgtYzE5ZWRjMGEtZTVjZS00OTA1LTgzMjQtYmU0YzdhZGJkYmMxLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA2MjklMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNjI5VDExNTUxNlomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTc4NmU5MmE3ZDE4NTFjOWEzZGE2NDU4MWUxNGY2MDFmZjAxYTkwNzc1MGI0NTg3ZTc0YWIwZDJmYWFlZjFiZGImWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JnJlc3BvbnNlLWNvbnRlbnQtdHlwZT1pbWFnZSUyRnBuZyJ9.UAvLKyqgM9O4eJSsydn7ObBIHYg1r_PuUC3YvWDZpUs)[![image](https://private-user-images.githubusercontent.com/24874264/425226695-53cdc2a1-c878-4818-b0c2-ed04afb18c61.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODI3MzQ0MTYsIm5iZiI6MTc4MjczNDExNiwicGF0aCI6Ii8yNDg3NDI2NC80MjUyMjY2OTUtNTNjZGMyYTEtYzg3OC00ODE4LWIwYzItZWQwNGFmYjE4YzYxLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA2MjklMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNjI5VDExNTUxNlomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPWIyM2NjOTU4ODdmODQ2YmUwYzk2YzIzMGI1ZTI2NzkxNDg0Y2E0YmRmZTU3ZmYyM2Y3ZjFjOTkwNWY0OGM2OTcmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JnJlc3BvbnNlLWNvbnRlbnQtdHlwZT1pbWFnZSUyRnBuZyJ9.KT3LlN-VIvVlEgl-Fi_l4XWwPI1Dkd3mMBMUnAvwxTM)](https://private-user-images.githubusercontent.com/24874264/425226695-53cdc2a1-c878-4818-b0c2-ed04afb18c61.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODI3MzQ0MTYsIm5iZiI6MTc4MjczNDExNiwicGF0aCI6Ii8yNDg3NDI2NC80MjUyMjY2OTUtNTNjZGMyYTEtYzg3OC00ODE4LWIwYzItZWQwNGFmYjE4YzYxLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA2MjklMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNjI5VDExNTUxNlomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPWIyM2NjOTU4ODdmODQ2YmUwYzk2YzIzMGI1ZTI2NzkxNDg0Y2E0YmRmZTU3ZmYyM2Y3ZjFjOTkwNWY0OGM2OTcmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JnJlc3BvbnNlLWNvbnRlbnQtdHlwZT1pbWFnZSUyRnBuZyJ9.KT3LlN-VIvVlEgl-Fi_l4XWwPI1Dkd3mMBMUnAvwxTM) or [![image](https://private-user-images.githubusercontent.com/24874264/425226721-2c59cadb-b74e-4e53-9fc7-e759016dd9d7.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODI3MzQ0MTYsIm5iZiI6MTc4MjczNDExNiwicGF0aCI6Ii8yNDg3NDI2NC80MjUyMjY3MjEtMmM1OWNhZGItYjc0ZS00ZTUzLTlmYzctZTc1OTAxNmRkOWQ3LnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA2MjklMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNjI5VDExNTUxNlomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTI1MjM4NDBhMDM3NjhlMDExNmJlOWFkOWY3MDNmMDg0MGMzZjA0NjA5NGNkNzNjMzM1NzlkZDcwNzJmMWU0MGQmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JnJlc3BvbnNlLWNvbnRlbnQtdHlwZT1pbWFnZSUyRnBuZyJ9.l4umAehNXJEg4GTeCRpWHq_hMO5pmcQ4f-9eR9WBXCs)](https://private-user-images.githubusercontent.com/24874264/425226721-2c59cadb-b74e-4e53-9fc7-e759016dd9d7.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODI3MzQ0MTYsIm5iZiI6MTc4MjczNDExNiwicGF0aCI6Ii8yNDg3NDI2NC80MjUyMjY3MjEtMmM1OWNhZGItYjc0ZS00ZTUzLTlmYzctZTc1OTAxNmRkOWQ3LnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA2MjklMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNjI5VDExNTUxNlomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTI1MjM4NDBhMDM3NjhlMDExNmJlOWFkOWY3MDNmMDg0MGMzZjA0NjA5NGNkNzNjMzM1NzlkZDcwNzJmMWU0MGQmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JnJlc3BvbnNlLWNvbnRlbnQtdHlwZT1pbWFnZSUyRnBuZyJ9.l4umAehNXJEg4GTeCRpWHq_hMO5pmcQ4f-9eR9WBXCs)[![image](https://private-user-images.githubusercontent.com/24874264/425226782-804cbdc4-058c-4e04-ad8c-a8304b090a8e.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODI3MzQ0MTYsIm5iZiI6MTc4MjczNDExNiwicGF0aCI6Ii8yNDg3NDI2NC80MjUyMjY3ODItODA0Y2JkYzQtMDU4Yy00ZTA0LWFkOGMtYTgzMDRiMDkwYThlLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA2MjklMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNjI5VDExNTUxNlomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPWEwZDBlY2U5YTA2NGE0MDJmN2UyZmRkMTJhMWE0N2IzYWJkYTMwYTQyNGJkZGZkMjU5NWE1MGVmYzMwNmFjNjYmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JnJlc3BvbnNlLWNvbnRlbnQtdHlwZT1pbWFnZSUyRnBuZyJ9.YtMlLqrge3QCPdUDaWvEEbvPzkv3VPbcbvm0cUYcdt4)](https://private-user-images.githubusercontent.com/24874264/425226782-804cbdc4-058c-4e04-ad8c-a8304b090a8e.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODI3MzQ0MTYsIm5iZiI6MTc4MjczNDExNiwicGF0aCI6Ii8yNDg3NDI2NC80MjUyMjY3ODItODA0Y2JkYzQtMDU4Yy00ZTA0LWFkOGMtYTgzMDRiMDkwYThlLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA2MjklMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNjI5VDExNTUxNlomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPWEwZDBlY2U5YTA2NGE0MDJmN2UyZmRkMTJhMWE0N2IzYWJkYTMwYTQyNGJkZGZkMjU5NWE1MGVmYzMwNmFjNjYmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JnJlc3BvbnNlLWNvbnRlbnQtdHlwZT1pbWFnZSUyRnBuZyJ9.YtMlLqrge3QCPdUDaWvEEbvPzkv3VPbcbvm0cUYcdt4)[![image](https://private-user-images.githubusercontent.com/24874264/425226804-bfd327e3-06f3-4f3c-9475-45bb58392cf1.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODI3MzQ0MTYsIm5iZiI6MTc4MjczNDExNiwicGF0aCI6Ii8yNDg3NDI2NC80MjUyMjY4MDQtYmZkMzI3ZTMtMDZmMy00ZjNjLTk0NzUtNDViYjU4MzkyY2YxLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA2MjklMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNjI5VDExNTUxNlomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPThmMzE4Njg5Mjk0MmMzOWY3YjczY2UxMWE4MjQ5ZjMyMDI1ZWFlZDYwNmRiMjU4NWJmNzkyMDM5NTg2MzEyZTUmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JnJlc3BvbnNlLWNvbnRlbnQtdHlwZT1pbWFnZSUyRnBuZyJ9.7MlE_SR1Y_0EAV_Xscl1ikVWDrKfil4oumVdmMTOG8k)](https://private-user-images.githubusercontent.com/24874264/425226804-bfd327e3-06f3-4f3c-9475-45bb58392cf1.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODI3MzQ0MTYsIm5iZiI6MTc4MjczNDExNiwicGF0aCI6Ii8yNDg3NDI2NC80MjUyMjY4MDQtYmZkMzI3ZTMtMDZmMy00ZjNjLTk0NzUtNDViYjU4MzkyY2YxLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA2MjklMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNjI5VDExNTUxNlomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPThmMzE4Njg5Mjk0MmMzOWY3YjczY2UxMWE4MjQ5ZjMyMDI1ZWFlZDYwNmRiMjU4NWJmNzkyMDM5NTg2MzEyZTUmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JnJlc3BvbnNlLWNvbnRlbnQtdHlwZT1pbWFnZSUyRnBuZyJ9.7MlE_SR1Y_0EAV_Xscl1ikVWDrKfil4oumVdmMTOG8k)

### If you use Laravel IDEA

[](#if-you-use-laravel-idea)

[![image](https://private-user-images.githubusercontent.com/24874264/425226872-50c0f082-58d4-496d-8439-5b549e04e056.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODI3MzQ0MTYsIm5iZiI6MTc4MjczNDExNiwicGF0aCI6Ii8yNDg3NDI2NC80MjUyMjY4NzItNTBjMGYwODItNThkNC00OTZkLTg0MzktNWI1NDllMDRlMDU2LnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA2MjklMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNjI5VDExNTUxNlomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTRiOGY5MTIxMGQyZGU3YjBmNWU5OWU3MDUxYzliMmRkMjBjMjVmOWUyYTVkYjRhYTg3ZDM2ODAwYWNkNDAzNmEmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JnJlc3BvbnNlLWNvbnRlbnQtdHlwZT1pbWFnZSUyRnBuZyJ9._s4MBe_zd4fP8ofqsvW7R6Sr462SLWKIVMUA55bfiOk)](https://private-user-images.githubusercontent.com/24874264/425226872-50c0f082-58d4-496d-8439-5b549e04e056.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODI3MzQ0MTYsIm5iZiI6MTc4MjczNDExNiwicGF0aCI6Ii8yNDg3NDI2NC80MjUyMjY4NzItNTBjMGYwODItNThkNC00OTZkLTg0MzktNWI1NDllMDRlMDU2LnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA2MjklMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNjI5VDExNTUxNlomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTRiOGY5MTIxMGQyZGU3YjBmNWU5OWU3MDUxYzliMmRkMjBjMjVmOWUyYTVkYjRhYTg3ZDM2ODAwYWNkNDAzNmEmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JnJlc3BvbnNlLWNvbnRlbnQtdHlwZT1pbWFnZSUyRnBuZyJ9._s4MBe_zd4fP8ofqsvW7R6Sr462SLWKIVMUA55bfiOk)

### XDebug

[](#xdebug)

[![image](https://private-user-images.githubusercontent.com/24874264/425226920-d14ff2fb-359c-4a5e-8739-be4a63ecfe9b.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODI3MzQ0MTYsIm5iZiI6MTc4MjczNDExNiwicGF0aCI6Ii8yNDg3NDI2NC80MjUyMjY5MjAtZDE0ZmYyZmItMzU5Yy00YTVlLTg3MzktYmU0YTYzZWNmZTliLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA2MjklMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNjI5VDExNTUxNlomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTdhNjg2MzA2YzViMzVmOWQ3NTRlNjJiNGY1Yzc3OTdiMDFkZDc5Y2E1M2E5ZTg3NDU4MWQxZWFkMzhhZjc5MDQmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JnJlc3BvbnNlLWNvbnRlbnQtdHlwZT1pbWFnZSUyRnBuZyJ9.5tc3R7EV7kzmIljvXVKKrH7kY8xbKVePba6YIYSVK0o)](https://private-user-images.githubusercontent.com/24874264/425226920-d14ff2fb-359c-4a5e-8739-be4a63ecfe9b.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODI3MzQ0MTYsIm5iZiI6MTc4MjczNDExNiwicGF0aCI6Ii8yNDg3NDI2NC80MjUyMjY5MjAtZDE0ZmYyZmItMzU5Yy00YTVlLTg3MzktYmU0YTYzZWNmZTliLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA2MjklMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNjI5VDExNTUxNlomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTdhNjg2MzA2YzViMzVmOWQ3NTRlNjJiNGY1Yzc3OTdiMDFkZDc5Y2E1M2E5ZTg3NDU4MWQxZWFkMzhhZjc5MDQmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JnJlc3BvbnNlLWNvbnRlbnQtdHlwZT1pbWFnZSUyRnBuZyJ9.5tc3R7EV7kzmIljvXVKKrH7kY8xbKVePba6YIYSVK0o)[![image](https://private-user-images.githubusercontent.com/24874264/425226935-718cde26-37ac-42e4-91b7-319b6402a6e3.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODI3MzQ0MTYsIm5iZiI6MTc4MjczNDExNiwicGF0aCI6Ii8yNDg3NDI2NC80MjUyMjY5MzUtNzE4Y2RlMjYtMzdhYy00MmU0LTkxYjctMzE5YjY0MDJhNmUzLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA2MjklMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNjI5VDExNTUxNlomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTM5ODA4ZDk5NDhiMjAzNGI0NjA4MzE3MGYyNzBjZjZkODM2OGZiZTlmZGE3NzEyZDM0ZjBkOWEwY2JmMGNlYjAmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JnJlc3BvbnNlLWNvbnRlbnQtdHlwZT1pbWFnZSUyRnBuZyJ9.nup-tD7qrjK7Vny7_mMa-UrijT1fDy5n2UIAeIufVpM)](https://private-user-images.githubusercontent.com/24874264/425226935-718cde26-37ac-42e4-91b7-319b6402a6e3.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODI3MzQ0MTYsIm5iZiI6MTc4MjczNDExNiwicGF0aCI6Ii8yNDg3NDI2NC80MjUyMjY5MzUtNzE4Y2RlMjYtMzdhYy00MmU0LTkxYjctMzE5YjY0MDJhNmUzLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA2MjklMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNjI5VDExNTUxNlomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTM5ODA4ZDk5NDhiMjAzNGI0NjA4MzE3MGYyNzBjZjZkODM2OGZiZTlmZGE3NzEyZDM0ZjBkOWEwY2JmMGNlYjAmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JnJlc3BvbnNlLWNvbnRlbnQtdHlwZT1pbWFnZSUyRnBuZyJ9.nup-tD7qrjK7Vny7_mMa-UrijT1fDy5n2UIAeIufVpM)[![image](https://private-user-images.githubusercontent.com/24874264/425226948-2469193b-cd63-4f43-99fb-04616c3dbd8d.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODI3MzQ0MTYsIm5iZiI6MTc4MjczNDExNiwicGF0aCI6Ii8yNDg3NDI2NC80MjUyMjY5NDgtMjQ2OTE5M2ItY2Q2My00ZjQzLTk5ZmItMDQ2MTZjM2RiZDhkLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA2MjklMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNjI5VDExNTUxNlomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTQ2NTg2MTU3NDMzNmE3OGM1ZDMxY2M1NTllZjFiNjNkZDQ5MTA4NmI0ZjVmYTM5MzdkNWE1OTE4NWQ3NmViNmUmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JnJlc3BvbnNlLWNvbnRlbnQtdHlwZT1pbWFnZSUyRnBuZyJ9._BpRcTek7xWTEaFeGjs3_v_THLqP62RKwtpsFuB6tNM)](https://private-user-images.githubusercontent.com/24874264/425226948-2469193b-cd63-4f43-99fb-04616c3dbd8d.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODI3MzQ0MTYsIm5iZiI6MTc4MjczNDExNiwicGF0aCI6Ii8yNDg3NDI2NC80MjUyMjY5NDgtMjQ2OTE5M2ItY2Q2My00ZjQzLTk5ZmItMDQ2MTZjM2RiZDhkLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA2MjklMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNjI5VDExNTUxNlomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTQ2NTg2MTU3NDMzNmE3OGM1ZDMxY2M1NTllZjFiNjNkZDQ5MTA4NmI0ZjVmYTM5MzdkNWE1OTE4NWQ3NmViNmUmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JnJlc3BvbnNlLWNvbnRlbnQtdHlwZT1pbWFnZSUyRnBuZyJ9._BpRcTek7xWTEaFeGjs3_v_THLqP62RKwtpsFuB6tNM)

---

**🧪 Run Tests**
---------------

[](#-run-tests)

```
make test
```

or,

```
docker-compose exec -u www-data app php artisan test
```

---

📜 Additional Notes
------------------

[](#-additional-notes)

- This setup **supports Laravel Queues &amp; Scheduler** via **Supervisor**.
- **PostgreSQL, Redis &amp; Supervisor** are configured out of the box.
- Uses **Node.js 22** for Vite &amp; frontend dependencies.
- All **Docker volumes** persist data between container restarts.

---

🔥 Now your Laravel 12 project is fully containerized!
-----------------------------------------------------

[](#-now-your-laravel-12-project-is-fully-containerized)

Use **Makefile** commands just like **Laravel Sail**, and enjoy seamless **Docker development**! 🚀

---

🤖 Authors
---------

[](#-authors)

- [**m1n64**](https://github.com/m1n64)

###  Health Score

34

—

LowBetter than 75% of packages

Maintenance41

Moderate activity, may be stable

Popularity19

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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 ~4 days

Total

7

Last Release

471d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/068f8c26f06f513a9c38d2a01c4d90a85eae1125a5b9d14eae7059715be860e4?d=identicon)[m1n64](/maintainers/m1n64)

---

Top Contributors

[![m1n64](https://avatars.githubusercontent.com/u/24874264?v=4)](https://github.com/m1n64 "m1n64 (12 commits)")

---

Tags

frameworklaravel

###  Code Quality

TestsPHPUnit

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/m1n64-laravel-12-docker-startup/health.svg)

```
[![Health](https://phpackages.com/badges/m1n64-laravel-12-docker-startup/health.svg)](https://phpackages.com/packages/m1n64-laravel-12-docker-startup)
```

###  Alternatives

[unopim/unopim

UnoPim Laravel PIM

10.5k2.4k](/packages/unopim-unopim)[bagisto/bagisto

Bagisto Laravel E-Commerce

27.6k172.1k9](/packages/bagisto-bagisto)[codewithdennis/larament

Larament is a time-saving starter kit to quickly launch Laravel 13.x projects. It includes FilamentPHP 5.x pre-installed and configured, along with additional tools and features to streamline your development workflow.

3991.8k](/packages/codewithdennis-larament)[ercogx/laravel-filament-starter-kit

This is a Filament v5 Starter Kit for Laravel 13, designed to accelerate the development of Filament-powered applications.

461.7k](/packages/ercogx-laravel-filament-starter-kit)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
