Kubeasy Documentation

Welcome to the Kubeasy Documentation!

Kubeasy is an interactive learning platform that helps developers master Kubernetes by solving real-world challenges in a safe, local environment.

What is Kubeasy?

Kubeasy drops you into broken Kubernetes scenarios — maybe a pod won't start, RBAC is blocking access, or a network policy is too restrictive. Your goal? Investigate, fix, and validate using real tools like kubectl.

No browser playgrounds. No multiple-choice questions. Just you, your terminal, and realistic problems to solve.

Documentation sections

For Users

Learn how to use Kubeasy to practice Kubernetes skills:

• Getting Started - Install the CLI and solve your first challenge
• How It Works - Understand the challenge workflow
• CLI Reference - Complete command reference
• Troubleshooting - Fix common issues

→ Start with the User Guide

For Developers

Learn how to create and contribute challenges:

• Challenge Structure - Anatomy of a challenge
• Creating Challenges - Build your first challenge
• Validation Rules - Define success criteria
• Testing - Test challenges locally
• Contributing - Submission guidelines
• Operator API - Technical reference

→ Start with the Developer Guide

Key features

Local-first

Everything runs on your machine using Kind. No cloud account needed, no data leaves your system.

Real Kubernetes

Use kubectl, Lens, or any tool you prefer. The challenges run on actual Kubernetes, not a simulation.

Automated validation

Challenges validate themselves using:

• Kyverno - Prevents cheating by blocking invalid shortcuts
• Static validation - Checks resource configuration with Rego
• Dynamic validation - Verifies runtime behavior (logs, status, RBAC)

Progressive learning

Challenges range from beginner-friendly RBAC scenarios to advanced multi-component debugging.

Quick start

For learners

# Install the CLI
npm install -g @kubeasy-dev/kubeasy-cli

# Login with your API token
kubeasy login

# Setup your local environment
kubeasy setup

# Start a challenge
kubeasy challenge start rbac-basics

For contributors

# Clone the challenges repository
git clone https://github.com/kubeasy-dev/challenges.git
cd challenges

# Create your challenge
mkdir my-challenge
cd my-challenge
mkdir -p manifests validation/{kyverno,static,dynamic}

# Test it
kubeasy setup
kubectl apply -f manifests/
kubectl apply -f validation/

Philosophy

Kubeasy believes the best way to learn Kubernetes is through practice, not theory. By simulating real issues in isolated environments, you can safely explore, break things, and rebuild — developing a deeper understanding of how Kubernetes actually works.

Getting help

• User questions: GitHub Discussions
• Bug reports: GitHub Issues
• Website: kubeasy.dev

What's next?

• New to Kubeasy? → User Guide
• Want to contribute? → Developer Guide
• Need help? → Troubleshooting

Happy learning! 🚀