Dockerize Laravel App

NOTE: If you want to Dockerize Laravel, Postgres, Nginx, PGAdmin, Adminer, Mailhog, Npm and Redis. Please use this repo:

A simplified Docker Compose workflow that sets up relevant containers for Laravel development. (Laravel, Mysql, Nginx, PhpMyAdmin, Npm and Redis)

Usage

To get started, make sure you have Docker installed on your system, and then clone this repo.

Next, navigate in your terminal to the directory you cloned this repositoruy and run docker compose up -d --build.

After that, follow the steps from the src/README.md file to get your Laravel project up & running or create a new Laravel app.

Note: Your MySQL database host name should be mysql, note localhost. The username and database should both be homestead with a password of secret.

The containers and their exposed ports are:

• nginx - :80
• mysql - :3306
• php - :9000
• redis - :6379
• phpmyadmin - :8081

Use the following command examples from your root directory to run Composer, NPM or Artisan commands:

• docker compose run --rm composer install
• docker compose run --rm npm run dev
• docker compose run --rm artisan migrate

Makefile

There is a makefile which can help you to run every docker or artisan command easily. If you're not familiar with GNU Makefile it's ok and you can still use this repository (even you can delete makefile), but with makefile you can manage different commands easier and better! Before using a makefile just install it from GNU Makefile and run make command in repository root directory and you will see a help result to use it. Some of make command example to simplify workflow:

# run docker compose up -d
make up

# run docker compose down --volumes
make down-volumes

# run php artisan make:contoller
make contoller

# run php artisan make:resource
make resource

# run migrations
make migrate

# run tinker
make tinker

# run artisan commands
make art db:seed

# and more.. 

Persistent MySQL Storage

By default, whenever you bring down the Docker network, your MySQL data will be removed after the containers are destroyed. If you would like to have persistent data that remains after bringing containers down and back up, do the following:

1. Create a mysql folder in the project root, alongside the nginx and src folders.
2. Under the mysql service in your docker-compose.yml file, add the following lines:

volumes:
  - ./mysql:/var/lib/mysql

1. If you want to initialize database data with a sql file you should create a docker-entrypoint-initdb.d folder inside ./mysql and put your db.sql file into it.

another way of doing the 2,3:

volumes:
  mysql:
    driver: local

If you would like to have persistent redis data that remains after bringing containers down and back up:

volumes:
  - redis:/data

volumes: mysql: driver: local redis: driver: local

## Docker exec container

Access container as interactive shell and see output:

docker exec -it sh

Tip: You may use /bin/bash or just bash so after installing bash, you should inspect your image to understand CMD part and change current
option to whatever you want. For this purpose run:

docker inspect [imageID]

## Usage in Production

Tip 1: Don't forget to configure opcache
Tip 2: Don't forget about SSL

## Compiling Assets

It is better to compile assets in production mode. You need to add ` --host 0.0.0.0` after the end of your dev command in `package.json`. For example, with a Laravel project using Vite, you should have:

```json
"scripts": {
  "dev": "vite --host 0.0.0.0",
  "build": "vite build"
},

Then, run the following commands to install your dependencies and start the dev server:

• docker compose run --rm npm install
• docker compose run --rm --service-ports npm run dev

If you want to build for production? simply run docker compose run --rm npm run build.

Description

A simplified Docker Compose workflow that sets up a Laravel network of containers for local Laravel development with Adminer & PGAdmin.

License

This project is licensed under the MIT License. See the full license below:

MIT License

Copyright (c) 2025 Reza Khademi

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Unauthorized Use Warning

Unauthorized copying, modification, or distribution of this code without proper attribution is strictly prohibited. If you see this code being misused, please report it.

Contact

If you have any questions, feel free to reach out at rezakhademix@gmail.com.