10c9e0d854
Complete restructure from patterns/examples/reference to technology-focused directories: • Created technology-specific directories with comprehensive documentation: - /tdarr/ - Transcoding automation with gaming-aware scheduling - /docker/ - Container management with GPU acceleration patterns - /vm-management/ - Virtual machine automation and cloud-init - /networking/ - SSH infrastructure, reverse proxy, and security - /monitoring/ - System health checks and Discord notifications - /databases/ - Database patterns and troubleshooting - /development/ - Programming language patterns (bash, nodejs, python, vuejs) • Enhanced CLAUDE.md with intelligent context loading: - Technology-first loading rules for automatic context provision - Troubleshooting keyword triggers for emergency scenarios - Documentation maintenance protocols with automated reminders - Context window management for optimal documentation updates • Preserved valuable content from .claude/tmp/: - SSH security improvements and server inventory - Tdarr CIFS troubleshooting and Docker iptables solutions - Operational scripts with proper technology classification • Benefits achieved: - Self-contained technology directories with complete context - Automatic loading of relevant documentation based on keywords - Emergency-ready troubleshooting with comprehensive guides - Scalable structure for future technology additions - Eliminated context bloat through targeted loading 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
1.7 KiB
1.7 KiB
Docker Troubleshooting Reference
Container Won't Start
Check logs
docker logs <container_name>
docker logs --tail 50 -f <container_name>
Common issues
- Port already in use:
docker psto find conflicting containers - Permission errors: Check file ownership and container user
- Missing environment variables: Verify with
docker exec -it <container> env - Resource limits: Check memory/CPU constraints
Debug running container
docker exec -it <container> /bin/bash
docker exec -it <container> /bin/sh # if bash not available
Build Issues
Clear build cache
docker system prune -a
docker builder prune
Build with verbose output
docker build --progress=plain --no-cache .
Common build failures
- COPY/ADD errors: Check file paths and .dockerignore
- Package installation: Update package lists first
- Network issues: Check DNS and proxy settings
Performance Issues
Container resource usage
docker stats
docker exec <container> top
docker exec <container> free -h
Image size optimization
docker images --format "table {{.Repository}}\t{{.Tag}}\t{{.Size}}"
docker history <image>
Network Debugging
List networks and connections
docker network ls
docker network inspect <network_name>
docker port <container>
Test connectivity
docker exec <container> ping <target>
docker exec <container> nslookup <hostname>
docker exec <container> netstat -tulpn
Quick Fixes
Remove all stopped containers
docker container prune
Remove unused images
docker image prune -a
Reset Docker completely
docker system prune -a --volumes