reference

v2026.09.24

Reference documentation for docker-local architecture, commands, and configuration

GitHub
Install command
npx skhub add mwguerra/reference
Markdown
SKILL.md

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)

ServiceHostPortUserPassword
MySQLmysql3306laravelsecret
PostgreSQLpostgres5432laravelsecret
Redisredis6379--
Mailpitmailpit1025--
MinIOminio9000miniominio123

Root MySQL password: secret

URLs

ServiceURL
Projectshttps://{project}.test
Subdomainshttps://{sub}.{project}.test
Traefikhttps://traefik.localhost:8080
Mailpithttps://mail.localhost
MinIO Consolehttps://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

PathPurpose
~/projects/Default projects directory
~/projects/.docker-local-links/Symlinks for Nginx routing
~/.config/docker-local/Configuration directory
~/.config/docker-local/config.jsonMain 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

SymptomLikely CauseFix
404 errorMissing symlinkdocker-local link
"Site can't be reached"DNS not configuredCheck /etc/hosts or dnsmasq
Certificate errorCerts not generateddocker-local ssl:regenerate
Certificate still failingmkcert not trustedsudo mkcert -install
Container unhealthyService crashdocker-local restart
DB connection refusedWrong DB_HOSTUse 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.

Discovery
Tags

No tags published for this skill.

Version
Latest version metadata

Version

v2026.09.24

Published

Sep 24, 2026

Category

Uncategorized

License

Not specified

Source path

docker-local/skills/reference

Default branch

main

Latest commit

965b237

Tree SHA

3cf9655