README

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

🛠 Setup Instructions

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

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:

🚀 Start Containers

🔹 Using Docker

docker-compose up -d

🔹 Using Makefile

make up    # For development
make prod  # For production

📦 Install 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 & NPM Dependencies

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

🔑 Generate App Key

make artisan key:generate

📜 Run Migrations

make artisan migrate

🔗 Create Storage Symlink

make artisan storage:link

💻 Available Commands

🛠 Running Laravel Commands

🛑 Managing Containers

🔄 Restart & Stop

For list of all makefile commands, run make help.

💡 PHPStorm Setup

PHP Interpreter

or

If you use Laravel IDEA

XDebug

🧪 Run Tests

make test

or,

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

📜 Additional Notes

• 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.

🔥 Now your Laravel 12 project is fully containerized!

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

🤖 Authors

• m1n64