How do I install the Laravel Sail skill?

Run npx skillmds@latest add majiayu000/laravel-sail in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Laravel Sail safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: CAUTION, Skill Scanner: PASS. Capability flags: reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Laravel Sail?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Laravel Sail free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Laravel Sail?

majiayu000 (@majiayu000) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Laravel Sail by majiayu000 — Agent Skill

Name: Laravel Sail
Rating: 4.5 (4 reviews)
Author: majiayu000

Laravel Sail

Develops with Laravel Sail Docker environment. Activates when working with Docker containers, Sail commands, adding services (MySQL, Redis, Meilisearch), or when user mentions Sail, Docker, container, sail up, or development environment.

majiayu000 Updated Sep 9, 2026 567 repo stars

File contents

Laravel Sail Development

When to Apply

Activate this skill when:

Starting or stopping the Docker environment
Adding services to Sail (MySQL, Redis, etc.)
Running commands inside containers
Debugging container issues
Configuring Docker services

Documentation

Use search-docs for detailed Laravel Sail patterns and documentation.

Basic Commands

Starting and Stopping

# Start all containers
./vendor/bin/sail up

# Start in background (detached)
./vendor/bin/sail up -d

# Stop containers
./vendor/bin/sail down

# Stop and remove volumes (reset databases)
./vendor/bin/sail down -v

Running Commands

# Run Artisan commands
./vendor/bin/sail artisan migrate

# Run Composer
./vendor/bin/sail composer require package/name

# Run NPM
./vendor/bin/sail npm install
./vendor/bin/sail npm run dev

# Run tests
./vendor/bin/sail test

# Run Tinker
./vendor/bin/sail tinker

Shell Access

# Access application container shell
./vendor/bin/sail shell

# Run command as root
./vendor/bin/sail root-shell

Adding Services

# Add services interactively
php artisan sail:add

# Or specify services
php artisan sail:add mysql redis meilisearch

Available Services

MySQL 8.0
PostgreSQL
MariaDB
Redis
Memcached
Meilisearch
Typesense
MinIO
Mailpit
Selenium

Configuration

docker-compose.yml

Environment Variables

Database connection

DB_CONNECTION=mysql DB_HOST=mysql DB_PORT=3306 DB_DATABASE=laravel DB_USERNAME=sail DB_PASSWORD=password

Redis

REDIS_HOST=redis REDIS_PASSWORD=null REDIS_PORT=6379

Sail Alias

Add to your shell profile for convenience:

# ~/.bashrc or ~/.zshrc
alias sail='[ -f sail ] && sh sail || sh vendor/bin/sail'

Then use:

sail up -d
sail artisan migrate
sail npm run dev

Database Access

# MySQL CLI
./vendor/bin/sail mysql

# PostgreSQL CLI
./vendor/bin/sail psql

# Redis CLI
./vendor/bin/sail redis

Debugging

# View container logs
./vendor/bin/sail logs

# View specific service logs
./vendor/bin/sail logs mysql

# Follow logs
./vendor/bin/sail logs -f

Xdebug

Publishing Sail Files

# Publish docker-compose.yml and Dockerfiles
php artisan sail:publish

This allows customizing the Docker configuration.

Common Pitfalls

Forgetting to start Sail before running commands
Using localhost instead of service names for connections (use mysql not localhost)
Port conflicts with local services
Not using sail prefix for commands (running php artisan instead of sail artisan)
Volume permission issues (use sail root-shell to fix)
Forgetting to rebuild after Dockerfile changes (sail build --no-cache)

---name: laravel-saildescription: Develops with Laravel Sail Docker environment. Activates when working with Docker containers, Sail commands, adding services (MySQL, Redis, Meilisearch), or when user mentions Sail, Docker, container, sail up, or development environment.--- # Laravel Sail Development ## When to Apply Activate this skill when: - Starting or stopping the Docker environment - Adding services to Sail (MySQL, Redis, etc.) - Running commands inside containers - Debugging container issues - Configuring Docker services ## Documentation Use `search-docs` for detailed Laravel Sail patterns and documentation. ## Basic Commands ### Starting and Stopping ```bash # Start all containers ./vendor/bin/sail up # Start in background (detached) ./vendor/bin/sail up -d # Stop containers ./vendor/bin/sail down # Stop and remove volumes (reset databases) ./vendor/bin/sail down -v ``` ### Running Commands ```bash # Run Artisan commands ./vendor/bin/sail artisan migrate # Run Composer ./vendor/bin/sail composer require package/name # Run NPM ./vendor/bin/sail npm install ./vendor/bin/sail npm run dev # Run tests ./vendor/bin/sail test # Run Tinker ./vendor/bin/sail tinker ``` ### Shell Access ```bash # Access application container shell ./vendor/bin/sail shell # Run command as root ./vendor/bin/sail root-shell ``` ## Adding Services ```bash # Add services interactively php artisan sail:add # Or specify services php artisan sail:add mysql redis meilisearch ``` ### Available Services - MySQL 8.0 - PostgreSQL - MariaDB - Redis - Memcached - Meilisearch - Typesense - MinIO - Mailpit - Selenium ## Configuration ### docker-compose.yml <code-snippet name="Custom Service" lang="yaml"> # docker-compose.yml services: laravel.test: build: context: ./vendor/laravel/sail/runtimes/8.3 dockerfile: Dockerfile ports: - '${APP_PORT:-80}:80' environment: WWWUSER: '${WWWUSER}' LARAVEL_SAIL: 1 volumes: - '.:/var/www/html' networks: - sail depends_on: - mysql - redis </code-snippet> ### Environment Variables <code-snippet name="Sail Environment" lang="env"> # .env APP_PORT=80 FORWARD_DB_PORT=3306 FORWARD_REDIS_PORT=6379 # Database connection DB_CONNECTION=mysql DB_HOST=mysql DB_PORT=3306 DB_DATABASE=laravel DB_USERNAME=sail DB_PASSWORD=password # Redis REDIS_HOST=redis REDIS_PASSWORD=null REDIS_PORT=6379 </code-snippet> ## Sail Alias Add to your shell profile for convenience: ```bash # ~/.bashrc or ~/.zshrc alias sail='[ -f sail ] && sh sail || sh vendor/bin/sail' ``` Then use: ```bash sail up -d sail artisan migrate sail npm run dev ``` ## Database Access ```bash # MySQL CLI ./vendor/bin/sail mysql # PostgreSQL CLI ./vendor/bin/sail psql # Redis CLI ./vendor/bin/sail redis ``` ## Debugging ```bash # View container logs ./vendor/bin/sail logs # View specific service logs ./vendor/bin/sail logs mysql # Follow logs ./vendor/bin/sail logs -f ``` ### Xdebug <code-snippet name="Enable Xdebug" lang="env"> # .env SAIL_XDEBUG_MODE=develop,debug SAIL_XDEBUG_CONFIG="client_host=host.docker.internal" </code-snippet> ## Publishing Sail Files ```bash # Publish docker-compose.yml and Dockerfiles php artisan sail:publish ``` This allows customizing the Docker configuration. ## Common Pitfalls - Forgetting to start Sail before running commands - Using `localhost` instead of service names for connections (use `mysql` not `localhost`) - Port conflicts with local services - Not using `sail` prefix for commands (running `php artisan` instead of `sail artisan`) - Volume permission issues (use `sail root-shell` to fix) - Forgetting to rebuild after Dockerfile changes (`sail build --no-cache`)

Frequently asked questions