docker-laravel 🐳

Introduction

Build a simple laravel development environment with Docker Compose. Support with Windows(WSL2), macOS(Intel and Apple Silicon) and Linux.

Usage

Create an initial Laravel project

1. ClickUse this template
2. Git clone & change directory
3. Execute the following command

$ task for-linux-env#Linux environment only
$ task create-project

#or...

$ make for-linux-env#Linux environment only
$ make create-project

#or...

$echo"UID=$(id -u)">>.env#Linux environment only
$echo"GID=$(id -g)">>.env#Linux environment only

$ mkdir -p src
$ docker compose build
$ docker compose up -d
$ docker composeexecapp composer create-project --prefer-dist laravel/laravel.
$ docker composeexecapp php artisan key:generate
$ docker composeexecapp php artisan storage:link
$ docker composeexecapp chmod -R 777 storage bootstrap/cache
$ docker composeexecapp php artisan migrate

http://localhost

Create an existing Laravel project

1. Git clone & change directory
2. Execute the following command

$ task for-linux-env#Linux environment only
$ task install

#or...

$ make for-linux-env#Linux environment only
$ make install

#or...

$echo"UID=$(id -u)">>.env#Linux environment only
$echo"GID=$(id -g)">>.env#Linux environment only

$ docker compose build
$ docker compose up -d
$ docker composeexecapp composer install
$ docker composeexecapp cp.env.example.env
$ docker composeexecapp php artisan key:generate
$ docker composeexecapp php artisan storage:link
$ docker composeexecapp chmod -R 777 storage bootstrap/cache

http://localhost

Tips

• Read thisTaskfile.
• Read thisMakefile.
• Read thisWiki.

Container structures

├── app
├── web
└── db

app container

• Base image
  • php:8.3-fpm-bullseye
  • composer:2.7

web container

• Base image
  • nginx:1.26

db container

• Base image
  • mysql:8.4

mailpit container

• Base image
  • axllent/mailpit