DockerQuest

DockerQuest is a terminal-based learning game to practice Docker from basics to production debugging.

You learn commands, investigate broken container scenarios, apply fixes, and validate your results.

Features

• 25 challenge levels across 5 worlds
• Teach Me Docker mode with progressive command lessons
• I Know Docker mode for hands-on incident fixing
• Rule-based validation using real Docker container state
• XP/progress tracking with level and world progression

What You Will Learn

• Core Docker CLI: run, ps, logs, exec, inspect, stop/start/rm
• Container config: ports, env vars, volumes, restart policies
• Image workflows: build, tag, push, history, digest awareness
• Networking: bridge/custom networks, DNS, connectivity checks
• Security hardening: root user, mounts, capabilities, read-only FS
• Production operations: healthchecks, logging drivers, resource limits

Requirements

• Python 3.8+
• Docker Desktop (or Docker Engine) running

Installation

git clone https://github.com/KanaparthyPraveen/DockersQuest
cd DockerQuest

python -m venv .venv
# Windows
.venv\Scripts\activate
# Linux/macOS
source .venv/bin/activate

pip install -r requirements.txt
pip install -e .

Run

python main.py

Or use the CLI entrypoint:

dockerquest

How To Play

1. Start Docker Desktop / Docker Engine.
2. Launch DockerQuest.
3. Choose a mode:
   • Teach Me Docker: command-first learning path
   • I Know Docker: incident challenges and validation
4. Use Another terminal to run Docker commands.
5. Use validate in challenge levels to check fixes.

Important Notes

• Keep Docker running before launching the app.
• Progress is saved locally and resumes automatically.
• If a challenge container already exists, DockerQuest re-provisions it.

Documentation(coming soon)

• Architecture: ARCHITECTURE.md
• Contributor guide: CONTRIBUTING.md
• Level design: docs/level_design.md
• Error handbook: docs/docker_error_handbook.md

License

GNU General Public License v3.0 (GPL-3.0)