README.md

June 14, 2026 · View on GitHub

GitHub stars

Full PHP development environment based on Docker.

Use Docker First - Learn About It Later!

Overview

Laradock is a full PHP development environment for Docker. It ships pre-configured, ready-to-use containers for everything a PHP application needs (Nginx, PHP-FPM, MySQL, PostgreSQL, Redis, and many more), so you can launch a complete local stack in seconds without any manual setup.

It works with any PHP project and behaves the same on Linux, macOS, and Windows.

Quick Start

Set up a demo stack with PHP, NGINX, MySQL, Redis and Composer:

1 - Clone Laradock inside your PHP project:

git clone https://github.com/Laradock/laradock.git

2 - Enter the laradock folder and rename .env.example to .env.

cp .env.example .env

3 - Run your containers:

docker-compose up -d workspace nginx mysql redis

4 - Open your project's .env file and set the following:

DB_HOST=mysql
REDIS_HOST=redis
QUEUE_HOST=beanstalkd

5 - Open your browser and visit localhost: http://localhost.

Done.

Works With

Laradock provides the PHP runtime, web server, databases, and background services your app needs, so it runs virtually any PHP framework, CMS, or e-commerce platform:

Frameworks: Laravel, Symfony, CodeIgniter, Yii, Laminas (Zend Framework), CakePHP, Phalcon, Slim, Lumen, FuelPHP
CMS: WordPress, Drupal, Joomla, October CMS, Statamic, Craft CMS, TYPO3, Concrete CMS, Grav
E-commerce: Magento, WooCommerce, PrestaShop, OpenCart, Sylius, Bagisto
Apps: Moodle, MediaWiki, phpBB, Matomo

…or plain, framework-free PHP.

Key Features

Pre-configured stack: 70+ ready-to-use containers (Nginx, Apache, Caddy, PHP-FPM, MySQL, PostgreSQL, MariaDB, MongoDB, Redis, Memcached, Elasticsearch, RabbitMQ, Beanstalkd, and more).
All-in-one dev shell: run Artisan, Composer, Node, and every CLI your project needs inside the ready-made workspace container, with nothing installed on your host.
Easy version switching: change PHP (5.6–8.5), database, or service versions in one place.
Project-agnostic: works with Laravel, Symfony, WordPress, Drupal, Magento, or vanilla PHP.
Cross-platform: the same environment on Linux, macOS, and Windows.
Modular: run only the containers you need, in any combination.
Beginner-friendly: clone, copy the env file, and run docker compose up.

The Workspace: Your All-in-One Dev Shell

A command line preloaded with PHP, Composer, Node, Git, and dozens of dev tools, so you run every command your project needs inside it and install nothing on your own machine.

Enter it and work from there:

docker-compose exec workspace bash

artisan, composer, phpunit, npm, and git all just work, with nothing installed on your host: no PHP, no Composer, no Node, no version conflicts. Stop the project and zero traces are left on your device.

Why it's a big deal:

Start in seconds. Every tool is already installed and configured, so there's nothing to set up; clone a project and get to work.
Keep your machine spotless. Run everything inside the container; your host never gets PHP, Composer, Node, or any CLI, and nothing is left behind when you're done.
Isolate every project. Each one runs on its own PHP and database versions with no conflicts between them.
Revive old projects. Run legacy apps on older PHP (5.6, 7.x) without touching your system's PHP version.

Awesome People

Laradock is an MIT-licensed open source project with its ongoing development made possible entirely by the support of you and all these awesome people. 💜

Project Maintainers

Mahmoud Zalt @mahmoudz	Bo-Yi Wu @appleboy	Philippe Trépanier @philtrep	Mike Erickson @mikeerickson	Dwi Fahni Denni @zeroc0d3
Thor Erik @thorerik	Winfried van Loon @winfried-van-loon	TJ Miller @sixlive	Yu-Lung Shao (Allen) @bestlong	Milan Urukalo @urukalo
Vince Chu @vwchu	Huadong Zuo @zuohuadong	Lan Phan @lanphan	Ahkui @ahkui	< Join Us > @laradock