reference

name	reference
description	Reference documentation for docker-local architecture, commands, and configuration
alwaysAllow	["Read","Glob","Grep"]

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.