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

4. When you execute the command below

$ docker compose up -d

Remember to go inside your app docker container and check the composer/config.json and remove the \r in the URL

BAD JSON FILE

{
    "config": {
        "process-timeout": 3600},
    "repositories": {
        "packagist": {
            "type": "composer",
            "url": "https://packagist.org\r"
        }
    }
}

GOOD JSON FILE

{
    "config": {
        "process-timeout": 3600},
    "repositories": {
        "packagist": {
            "type": "composer",
            "url": "https://packagist.org"
        }
    }
}

5. Before executing the last command, change your DB_HOST form 127.0.0.1 to DB

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