mwguerra docker-local Reference
Quick reference for docker-local Laravel development environment.
When to Use
Use this reference when you need details about:
- Service credentials and ports
- docker-local CLI commands
- File paths and project structure
- .env configuration requirements
Service Credentials (Defaults)
| Service | Host | Port | User | Password |
|---|---|---|---|---|
| MySQL | mysql | 3306 | laravel | secret |
| PostgreSQL | postgres | 5432 | laravel | secret |
| Redis | redis | 6379 | - | - |
| Mailpit | mailpit | 1025 | - | - |
| MinIO | minio | 9000 | minio | minio123 |
Root MySQL password: secret
URLs
| Service | URL |
|---|---|
| Projects | https://{project}.test |
| Subdomains | https://{sub}.{project}.test |
| Traefik | https://traefik.localhost:8080 |
| Mailpit | https://mail.localhost |
| MinIO Console | https://minio.localhost |
Key Commands
Status & Health
docker-local status # Check all services and containers
docker-local doctor # Full health check with diagnostics
docker-local fix # Auto-fix common issues
Container Management
docker-local up # Start all containers
docker-local down # Stop all containers
docker-local restart # Restart all containers
docker-local logs [service] # View logs (nginx, php, mysql, redis, traefik)
Project Management
docker-local link # Rescan and link all projects
docker-local list # List all detected projects
docker-local make:laravel X # Create new Laravel project
docker-local open [project] # Open project in browser
SSL Certificates
docker-local ssl:status # Check certificate status
docker-local ssl:regenerate # Regenerate all certificates
Database
docker-local db:create X # Create MySQL database
docker-local db:mysql # Open MySQL CLI
docker-local db:postgres # Open PostgreSQL CLI
docker-local db:redis # Open Redis CLI
docker-local db:fresh # Run migrate:fresh --seed
Environment
docker-local env:check # Check .env for conflicts
docker-local config # Show current configuration
File Paths
| Path | Purpose |
|---|---|
~/projects/ |
Default projects directory |
~/projects/.docker-local-links/ |
Symlinks for Nginx routing |
~/.config/docker-local/ |
Configuration directory |
~/.config/docker-local/config.json |
Main config file |
~/.config/docker-local/certs/ |
SSL certificates |
Required .env Settings
For Laravel projects to work with docker-local:
APP_URL=https://myproject.test
# Database (MySQL)
DB_CONNECTION=mysql
DB_HOST=mysql
DB_PORT=3306
DB_DATABASE=myproject
DB_USERNAME=laravel
DB_PASSWORD=secret
# Redis
REDIS_HOST=redis
REDIS_PORT=6379
REDIS_PASSWORD=null
# Cache/Session/Queue isolation (unique per project)
CACHE_PREFIX=myproject_
REDIS_CACHE_DB=0
REDIS_SESSION_DB=1
REDIS_QUEUE_DB=2
# Mail
MAIL_MAILER=smtp
MAIL_HOST=mailpit
MAIL_PORT=1025
# S3/MinIO (optional)
AWS_ACCESS_KEY_ID=minio
AWS_SECRET_ACCESS_KEY=minio123
AWS_DEFAULT_REGION=us-east-1
AWS_BUCKET=myproject
AWS_ENDPOINT=http://minio:9000
AWS_USE_PATH_STYLE_ENDPOINT=true
Troubleshooting Quick Reference
| Symptom | Likely Cause | Fix |
|---|---|---|
| 404 error | Missing symlink | docker-local link |
| "Site can't be reached" | DNS not configured | Check /etc/hosts or dnsmasq |
| Certificate error | Certs not generated | docker-local ssl:regenerate |
| Certificate still failing | mkcert not trusted | sudo mkcert -install |
| Container unhealthy | Service crash | docker-local restart |
| DB connection refused | Wrong DB_HOST | Use mysql not 127.0.0.1 |
Multi-Project Isolation
Each project needs unique values to avoid conflicts:
- Database name - Unique per project
- Redis DBs - 3 DBs per project (0-2, 3-5, 6-8, etc.)
- Cache prefix - Unique string per project
- MinIO bucket - Unique per project
Use docker-local env:check --all to detect conflicts across projects.