Docker Local

Docker Compose Local Development

You are working with custom Docker Compose local development environments (non-DDEV).

Environment Detection

ls -la docker-compose*.yml compose*.yml .env* Makefile docker/ scripts/ 2>/dev/null

Common Commands

docker compose up -d              # Start in background
docker compose up -d --build      # Start with rebuild
docker compose down               # Stop and remove containers
docker compose down -v            # Also remove volumes (DATA LOSS!)
docker compose exec  
docker compose run --rm    # One-off (if not running)
docker compose ps && docker compose logs -f 

Drupal Docker Patterns

| Service Type | Common Names | |---|---| | PHP/Web | php, web, app, drupal, php-fpm | | Database | db, mysql, mariadb, postgres | | Cache | redis, memcached | | Search | solr, elasticsearch |

# Drush
docker compose exec php ./vendor/bin/drush cr

# MySQL import/export
docker compose exec -T db mysql -u root -p    > dump.sql

Troubleshooting

# Port conflicts
sudo lsof -i :80

# Container won't start
docker compose logs 
docker compose down && docker compose up -d --build

# Permissions
docker compose exec php chown -R www-data:www-data /var/www/html/web/sites/default/files

# Network: containers reach each other by service name (e.g. host: db)
docker network inspect _default

Environment Variables

Docker Compose auto-loads .env:

COMPOSE_PROJECT_NAME=myproject
MYSQL_ROOT_PASSWORD=root
MYSQL_DATABASE=drupal

Performance on macOS: use :cached volume flag and named volumes for vendor/.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: edutrul
• Source: edutrul/drupal-ai
• License: MIT
• Homepage: https://eduardotelaya.com/drupal-ai/

Install and usage instructions live in the source repository linked above.