$npx -y skills add edutrul/drupal-ai --skill docker-localCustom Docker Compose local development patterns. Use when working with Docker-based local environments, container configuration, or troubleshooting Docker setups.
| 1 | # Docker Compose Local Development |
| 2 | |
| 3 | You are working with custom Docker Compose local development environments (non-DDEV). |
| 4 | |
| 5 | ## Environment Detection |
| 6 | |
| 7 | ```bash |
| 8 | ls -la docker-compose*.yml compose*.yml .env* Makefile docker/ scripts/ 2>/dev/null |
| 9 | ``` |
| 10 | |
| 11 | ## Common Commands |
| 12 | |
| 13 | ```bash |
| 14 | docker compose up -d # Start in background |
| 15 | docker compose up -d --build # Start with rebuild |
| 16 | docker compose down # Stop and remove containers |
| 17 | docker compose down -v # Also remove volumes (DATA LOSS!) |
| 18 | docker compose exec <service> <cmd> |
| 19 | docker compose run --rm <service> <cmd> # One-off (if not running) |
| 20 | docker compose ps && docker compose logs -f <service> |
| 21 | ``` |
| 22 | |
| 23 | ## Drupal Docker Patterns |
| 24 | |
| 25 | | Service Type | Common Names | |
| 26 | |---|---| |
| 27 | | PHP/Web | `php`, `web`, `app`, `drupal`, `php-fpm` | |
| 28 | | Database | `db`, `mysql`, `mariadb`, `postgres` | |
| 29 | | Cache | `redis`, `memcached` | |
| 30 | | Search | `solr`, `elasticsearch` | |
| 31 | |
| 32 | ```bash |
| 33 | # Drush |
| 34 | docker compose exec php ./vendor/bin/drush cr |
| 35 | |
| 36 | # MySQL import/export |
| 37 | docker compose exec -T db mysql -u root -p<password> <database> < dump.sql |
| 38 | docker compose exec db mysqldump -u root -p<password> <database> > dump.sql |
| 39 | ``` |
| 40 | |
| 41 | ## Troubleshooting |
| 42 | |
| 43 | ```bash |
| 44 | # Port conflicts |
| 45 | sudo lsof -i :80 |
| 46 | |
| 47 | # Container won't start |
| 48 | docker compose logs <service> |
| 49 | docker compose down && docker compose up -d --build |
| 50 | |
| 51 | # Permissions |
| 52 | docker compose exec php chown -R www-data:www-data /var/www/html/web/sites/default/files |
| 53 | |
| 54 | # Network: containers reach each other by service name (e.g. host: db) |
| 55 | docker network inspect <project>_default |
| 56 | ``` |
| 57 | |
| 58 | ## Environment Variables |
| 59 | |
| 60 | Docker Compose auto-loads `.env`: |
| 61 | ```env |
| 62 | COMPOSE_PROJECT_NAME=myproject |
| 63 | MYSQL_ROOT_PASSWORD=root |
| 64 | MYSQL_DATABASE=drupal |
| 65 | ``` |
| 66 | |
| 67 | Performance on macOS: use `:cached` volume flag and named volumes for `vendor/`. |