README.md

docker-laravel 🐳

Introduction

Build a simple laravel development environment with docker-compose. Compatible with Windows(WSL2), macOS(M1) and Linux.

Usage

Create an initial Laravel project

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

$ task create-project

# or...

$ make create-project

# or...

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

http://localhost

Create an existing Laravel project

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

$ task install

# or...

$ make install

# or...

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

http://localhost

Tips

• Read this Taskfile.
• Read this Makefile.
• Read this Wiki.

Container structures

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

app container

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

web container

• Base image
  • nginx:1.25

db container

• Base image
  • mysql/mysql-server:8.0

mailpit container

• Base image
  • axllent/mailpit