# Docker Debugging

> Docker container debugging and management. Use when investigating container issues, checking logs, resource usage, or Docker Compose services.

- Skill: `incidentfox/docker-debugging` (Agent Skill, multi-file: 9 files)
- Install (CLI): `npx skillmds@latest add incidentfox/docker-debugging`
- Raw SKILL.md: https://api.skillmd.com/api/skills/incidentfox/docker-debugging/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: incidentfox (https://skillmd.com/u/incidentfox)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/incidentfox/docker-debugging

---


# Docker Debugging

## Authentication

Docker commands run directly via the Docker CLI. No API keys are needed - the Docker socket must be accessible in the sandbox environment.

---

## Available Scripts

All scripts are in `.claude/skills/infrastructure-docker/scripts/`

### container_ps.py - List Containers
```bash
python .claude/skills/infrastructure-docker/scripts/container_ps.py [--all]
```

### container_logs.py - Get Container Logs
```bash
python .claude/skills/infrastructure-docker/scripts/container_logs.py --container NAME_OR_ID [--tail 100]
```

### container_inspect.py - Inspect Container
```bash
python .claude/skills/infrastructure-docker/scripts/container_inspect.py --container NAME_OR_ID
```

### container_stats.py - Resource Usage Statistics
```bash
python .claude/skills/infrastructure-docker/scripts/container_stats.py [--container NAME_OR_ID]
```

### image_list.py - List Docker Images
```bash
python .claude/skills/infrastructure-docker/scripts/image_list.py [--filter "reference=myapp*"]
```

### compose_ps.py - List Compose Services
```bash
python .claude/skills/infrastructure-docker/scripts/compose_ps.py [--file docker-compose.yml] [--cwd /path]
```

### compose_logs.py - Get Compose Service Logs
```bash
python .claude/skills/infrastructure-docker/scripts/compose_logs.py [--services "api,db"] [--tail 100]
```

---

## Investigation Workflow

### Container Debugging
```
1. List containers: container_ps.py --all
2. Check logs: container_logs.py --container <name> --tail 200
3. Check resources: container_stats.py --container <name>
4. Inspect config: container_inspect.py --container <name>
```

### Docker Compose Debugging
```
1. Check services: compose_ps.py
2. Check logs: compose_logs.py --services "api,worker" --tail 100
```

---

## Anti-Patterns to Avoid

1. **Never run destructive commands** without explicit user approval (docker rm, docker rmi, docker system prune)
2. **Always use --tail** for logs to avoid overwhelming output
3. **Check container status first** before trying to exec into it