Docker-Local Troubleshoot

Diagnose and fix common docker-local issues.

0. Prerequisite Check

FIRST, verify docker-local is installed:

which docker-local > /dev/null 2>&1 && echo "docker-local: OK" || echo "docker-local: NOT INSTALLED"

If NOT installed, ask user to install:

composer global require mwguerra/docker-local
export PATH="$HOME/.composer/vendor/bin:$PATH"
docker-local init

1. Gather Information

# Check status
docker-local status

# View logs
docker-local logs --tail=50

# Check system
docker system df

2. Common Issues

Docker Not Running

# Check
docker info

# Fix (Linux)
sudo systemctl start docker

# Fix (macOS)
open -a Docker

Port Conflict

# Find what's using the port
lsof -i :3306

# Kill the process
kill $(lsof -t -i:3306)

# Or change port in ~/.config/docker-local/config.json

Container Won't Start

# Check logs
docker-local logs php

# Restart
docker-local restart

Cannot Connect to Database

# Verify container running
docker-local status

# Check .env has correct host
# DB_HOST=mysql (not localhost)

DNS Not Working

# Setup DNS
sudo docker-local setup:dns

# Or add to hosts
sudo docker-local setup:hosts

SSL Certificate Issues

# Regenerate certificates
docker-local init --certs

3. Full Reset

If all else fails:

# Stop everything
docker-local down

# Clean Docker
docker system prune -af
docker volume prune -f

# Reinitialize
docker-local init
docker-local up

4. Get More Help

# Full diagnostic
docker-local doctor

# View configuration
docker-local config

# Check specific service logs
docker-local logs mysql
docker-local logs php
docker-local logs traefik

$ARGUMENTS