A simplified Docker Compose workflow that sets up a Laravel network of containers for local Laravel development with Adminer & PGAdmin.
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. create a self-signed certificate for the nginx-server (only for development, for production use a real certificate)
mkdir ./ssl/certs
mkdir ./ssl/private
openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout ./ssl/private/localhost.key -out ./ssl/certs/localhost.crt -config ./ssl/localhost.conf
and spin up the containers for the web server by running docker compose up -d --build.
After that completes, follow the steps from the src directory readme file to get your Laravel project added in (or create a new blank Laravel app).
Note: Your Postgres database host name should be postgres, note localhost. The username and database should both be homestead with a password of secret.
The following are built for our web server, with their exposed ports detailed:
- portainer -
:9090 - nginx -
:443 - postgres -
:5432 - php -
:9000 - redis -
:6379 - adminer -
:8080 - pgadmin -
:8090
Three additional containers are included that handle Composer, NPM, and Artisan commands without having to have these platforms installed on your local computer. Use the following command examples from your project root, modifying them to fit your particular use case.
docker compose run --rm --user $(1000 -u):$(1000 -g) composer installdocker compose run --rm --user $(1000 -u):$(1000 -g) npm run devdocker compose run --rm --user $(1000 -u):$(1000 -g) artisan migrate
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..
Access container as interactive shell and see output:
docker exec -it <container id> 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]
Tip: Don't forget to install and configure opcache
While I originally created this template for local development, it's robust enough to be used in basic Laravel application deployments. The biggest recommendation would be to ensure that HTTPS is enabled by making additions to the nginx/default.conf file and utilizing something like Let's Encrypt to produce an SSL certificate.
This configuration should be able to compile assets with both laravel mix and vite. In order to get started, you first need to add --host 0.0.0.0 after the end of your relevant dev command in package.json. So for example, with a Laravel project using Vite, you should see:
"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 installdocker compose run --rm --service-ports npm run dev
Want to build for production? Simply run docker compose run --rm npm run build.
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 copying, modification, or distribution of this code without proper attribution is strictly prohibited. If you see this code being misused, please report it.
If you have any questions, feel free to reach out at rezakhademix@gmail.com.
