Service Issues¶

# Check service status
docker ps -a | grep service_name

# Check service logs
docker logs service_name --tail 50

# Check resource usage
docker stats service_name

# Check system resources
free -h
df -h

# Check memory usage
docker stats service_name --no-stream

# Increase memory limit
# Edit docker-compose.yml and increase mem_limit
mem_limit: 256m

# Check port usage
netstat -tulpn | grep :port

# Change port in docker-compose.yml
ports:
  - "8081:80"  # Use different port

# Check volumes
docker volume ls
docker volume inspect volume_name

# Fix permissions
docker exec service_name chown -R user:user /data

# Check environment variables
docker exec service_name env

# Validate configuration file
docker exec service_name cat /path/to/config

# Check recent logs
docker logs service_name --tail 100

# Look for error patterns
docker logs service_name | grep -i error

# Check resource limits
docker inspect service_name | grep -A 10 "Resources"

# Increase limits
docker update service_name --memory=512m

# Check health status
docker ps --format "table {{.Names}}\t{{.Status}}\t{{.Health}}"

# Test health endpoint
curl -f http://localhost:port/health || echo "Health check failed"

# Check file permissions
docker exec service_name ls -la /path/to/files

# Fix permissions
docker exec service_name chown -R user:user /path/to/files
docker exec service_name chmod -R 755 /path/to/files

# Check disk usage
df -h

# Check container disk usage
docker exec service_name du -sh /data

# Clean up old files
docker exec service_name find /data -name "*.log" -mtime +30 -delete

# Check volume integrity
docker volume inspect volume_name

# Recreate volume
docker volume rm volume_name
docker volume create volume_name

# Check port mapping
docker port service_name

# Test direct access
curl -I http://localhost:port

# Check network connectivity
docker exec service_name ping google.com

# Check DNS resolution
docker exec service_name nslookup service.brennan.page

# Test external DNS
docker exec service_name ping 8.8.8.8

# Check Caddy configuration
docker exec caddy cat /etc/caddy/Caddyfile | grep -A 5 service_name

# Test proxy
curl -H "Host: service.brennan.page" http://localhost:port

# Reload Caddy
docker restart caddy

# Check resource usage
docker stats --no-stream

# Check system load
uptime
free -h

# Optimize database
docker exec postgres psql -U homelab -d homelab -c "VACUUM ANALYZE;"

# Check memory usage
docker stats --no-stream

# Clean up Docker
docker system prune -f

# Restart services
docker compose restart

# Check CPU usage
docker stats --no-stream

# Identify process
docker exec service_name top

# Restart service
docker restart service_name

# Backup service data
docker cp -r /opt/homelab/services/service_name /opt/homelab/backups/service_name-$(date +%Y%m%d)

# Backup configuration
docker cp /opt/homelab/services/service_name/docker-compose.yml /opt/homelab/backups/

# Stop service
docker stop service_name

# Remove current data
rm -rf /opt/homelab/services/service_name/data

# Restore from backup
docker cp -r /opt/homelab/backups/service_name-20260116 /opt/homelab/services/service_name/data

# Start service
docker start service_name

# Stop and remove everything
docker compose down
rm -rf data
docker volume rm service_volume

# Start fresh
docker compose up -d

# System monitoring
docker stats --no-stream

# Log monitoring
docker logs service_name --tail 100 | grep -i error

# Health monitoring
docker ps --format "table {{.Names}}\t{{.Status}}\t{{.Health}}"