{"id":705,"date":"2025-09-21T17:59:00","date_gmt":"2025-09-21T17:59:00","guid":{"rendered":"https:\/\/1v0.net\/blog\/?p=705"},"modified":"2025-09-21T18:00:17","modified_gmt":"2025-09-21T18:00:17","slug":"laravel-sail-a-simple-docker-environment-for-laravel","status":"publish","type":"post","link":"https:\/\/1v0.net\/blog\/laravel-sail-a-simple-docker-environment-for-laravel\/","title":{"rendered":"Laravel Sail: A Simple Docker Environment for Laravel"},"content":{"rendered":"\n

Laravel Sail<\/strong> is the official Docker-based development environment for Laravel. It provides a simple command-line interface to start and manage a full PHP, MySQL, Redis, MailHog, and more stack without needing to install these services directly on your system. Sail makes it easy for teams to work with the same setup across Windows, macOS, and Linux.<\/p>\n\n\n\n

<\/div>\n\n\n\n

When I started collaborating with a distributed team on a Laravel project, one of the biggest challenges we faced was keeping our local environments consistent. Some developers were on Windows, others on macOS, and a few on Linux. Everyone had different PHP versions, MySQL setups, and node configurations. Debugging issues caused by environment mismatches became a nightmare, and we wasted valuable time just trying to align setups.<\/p>\n\n\n\n

That\u2019s when we introduced Laravel Sail<\/strong> into our workflow. Instead of installing PHP, Composer, and databases manually, we spun up the entire stack with Docker using Sail. Suddenly, every team member had the same environment, regardless of their operating system. It felt like a huge weight was lifted off our shoulders. I didn\u2019t have to explain how to install Redis or MailHog anymore \u2014 Sail handled it all out of the box.<\/p>\n\n\n\n

What I loved most was how easy it was to run Artisan, Composer, and even NPM commands through Sail without touching my system setup. Over time, I learned to customize the docker-compose.yml<\/code> file, adding services like Meilisearch and Selenium for browser testing. It turned into a portable development environment that made collaboration seamless. Looking back, adopting Sail was one of the smoothest decisions we ever made for productivity and sanity in Laravel development.<\/p>\n\n\n\n

<\/div>\n\n\n\n

Installing Laravel Sail<\/h3>\n\n\n
curl -s https:\/\/laravel.build\/example-app | bash<\/span>\ncd example-app\n.\/vendor\/bin\/sail up<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
This command creates a new Laravel project, installs Sail, and boots the Docker containers. The default stack includes PHP, MySQL, Redis, MailHog, and more.<\/p>\n\n\n\n
<\/div>\n\n\n\n
Running Commands with Sail<\/h3>\n\n\n
.\/vendor\/bin\/sail artisan migrate\n.\/vendor\/bin\/sail composer require<\/span> laravel\/sanctum\n.\/vendor\/bin\/sail npm install && .\/vendor\/bin\/sail npm run dev<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
These commands allow you to run Artisan, Composer, and NPM inside the Sail environment. This way your host machine doesn\u2019t need PHP or Node installed \u2014 Sail handles it all within Docker.<\/p>\n\n\n\n
<\/div>\n\n\n\n
Examples for PHP, MySQL, Redis and MailHog<\/h3>\n\n\n
# Run a PHP command inside the Sail container<\/span>\n.\/vendor\/bin\/sail php -v\n\n# Connect to the MySQL database<\/span>\n.\/vendor\/bin\/sail mysql -u root -p\n\n# Open a Redis CLI session<\/span>\n.\/vendor\/bin\/sail redis-cli\n\n# Access MailHog (fake email server)<\/span>\nhttp:\/\/localhost:8025<\/span><\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
With these commands, you can quickly interact with the core services Sail provides. Run PHP commands without installing PHP locally, manage your MySQL database directly inside the container, debug Redis queues, and view outgoing emails in MailHog via its web UI.<\/p>\n\n\n\n
<\/div>\n\n\n\n
Real-World Use Cases<\/h3>\n\n\n
# Run a Redis queue worker<\/span>\n.\/vendor\/bin\/sail artisan queue:work\n\n# Send a test email (check in MailHog)<\/span>\n.\/vendor\/bin\/sail tinker\n>>> Mail::raw('Hello from Sail!'<\/span>, fn($m) => $m->to('test@example.com'<\/span>));<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
These examples show how Sail makes development practical. You can process jobs using Redis queues directly inside the container, and test email delivery with MailHog before sending anything to real users. This workflow improves reliability while keeping your system isolated and clean.<\/p>\n\n\n\n
<\/div>\n\n\n\n
Customizing Sail<\/h3>\n\n\n
# docker-compose.yml<\/span>\n\nservices:\n  laravel.test:\n    build:\n      context: .\/vendor\/laravel\/sail\/runtimes\/8.2<\/span>\n    ports:\n      - '80:80'<\/span>\n    volumes:\n      - '.:\/var\/www\/html'<\/span>\n  mysql:\n    image: 'mysql:8.0'<\/span>\n  redis:\n    image: 'redis:alpine'<\/span>\n  meilisearch:\n    image: 'getmeili\/meilisearch:latest'<\/span><\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
You can extend Sail by editing the docker-compose.yml<\/code> file. Here we\u2019ve added Meilisearch for search functionality alongside MySQL and Redis. Sail makes it easy to spin up additional services without complex configuration.<\/p>\n\n\n\n
<\/div>\n\n\n\n
Tips and Tricks<\/h3>\n\n\n\n