Crawbl Documentation
If this is your first day, do not try to read everything.
Read these four pages in order:
That gets you from zero context to a working local setup and a basic picture of the system.
Set Up Your Machine
Install tools, get access, and make sure your laptop can talk to Crawbl
Use The Shared Dev Environment
Find the live URLs, test with the E2E token, and learn what is already running for you
Understand The System
Learn the moving pieces: orchestrator, metacontroller, UserSwarm, ZeroClaw, and security
Run It Locally
Start the backend, hit the health endpoint, and run tests without needing Kubernetes first
Build Features
Add endpoints, write migrations, and follow the code patterns the backend already uses
Ship Changes
Learn what CI deploys automatically, when to build images yourself, and how to verify the result
Fix Problems Fast
Use the runbooks for crash loops, secret sync issues, auth failures, image pulls, and cleanup problems
Use reference pages when you already know what you are looking for and just need the exact command, path, endpoint, or config value.
API Reference
Routes, auth rules, payload shapes, and realtime events
Database
How the schema is organized, what tables exist, and how migrations are applied
CLI & Commands
crawbl commands, common kubectl checks, and the shortcuts people use every day
Infrastructure
Pulumi, ArgoCD, namespaces, ingress, secrets, and runtime isolation