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 & Scheduler
• Makefile for easy commands (like Laravel Sail)
• Nginx
• Composer
• XDebug in Dev Mode

And useful libraries:

• Telescope
• Horizon
• Log Viewer
• Scramble DeDoc

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

cp .env.example .env

• Open .env file and change it:

DB_DATABASE=<your-db> # 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:

docker-compose up -d

make up    # For development
make prod  # For production

Run inside the container:

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

Or using Makefile:

make composer install

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

make artisan key:generate

make artisan migrate

make artisan storage:link

For list of all makefile commands, run make help.

or

make test

or,

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

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

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

• m1n64