Fawkes is an open-source Internal Product Delivery Platform that wires together
Backstage, ArgoCD, Jenkins, Prometheus, and a belt-level Dojo learning environment
into a single GitOps-managed stack. Deploy it locally in ~20 minutes with
make dev-up, or to AWS EKS in 2–4 hours. All five DORA metrics (deployment frequency,
lead time, change failure rate, mean time to restore, and deployment rework rate) are
collected automatically from day one.
| DORA Metric | Elite Target |
|---|---|
| Deployment Frequency | Multiple times per day |
| Lead Time for Changes | < 1 hour |
| Change Failure Rate | 0–15% |
| Time to Restore Service | < 1 hour |
| Deployment Rework Rate | < 5% |
┌─────────────────────────────────────────────────────────────┐
│ Fawkes Product Delivery Platform │
├─────────────────────────────────────────────────────────────┤
│ ┌────────────────────────────────────────────────────┐ │
│ │ Backstage Developer Portal + Dojo Hub │ │
│ └────────────────────────────────────────────────────┘ │
│ │ │
│ ┌────────┴─────────┬──────────────┬─────────────┐ │
│ │ Collaboration │ Project │ Dojo │ │
│ │ (Mattermost) │ (Focalboard) │ Learning │ │
│ └──────────────────┴──────────────┴─────────────┘ │
│ │ │
│ ┌────────┴──────────────────────────────────────┐ │
│ │ CI/CD • GitOps • Observability • Security │ │
│ └───────────────────────────────────────────────┘ │
│ │ │
│ ┌────────┴──────────────────────────────────────┐ │
│ │ Kubernetes + Multi-Cloud Infrastructure │ │
│ └───────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────┘
- Platform engineering teams who want a production-ready IDP without starting from scratch.
- DevOps teams moving toward platform engineering and needing a concrete reference implementation.
- Engineering leaders who want automated DORA metrics and a paved path to elite delivery performance.
- Platform engineering learners who want hands-on labs on real infrastructure instead of sandbox toys.
| Tool | Minimum version | Install |
|---|---|---|
| Docker | 24+ | https://docs.docker.com/get-docker/ |
| k3d | 5+ | brew install k3d or https://k3d.io/#installation |
| kubectl | 1.28+ | brew install kubectl |
| Helm | 3.12+ | brew install helm |
| Make | any | Pre-installed on macOS/Linux |
Resource requirements: 4 CPU cores · 8 GB RAM · 20 GB free disk space
git clone https://github.com/paruff/fawkes.git && cd fawkes
make check-deps # verify prerequisites
make dev-up # spin up local k3d cluster (~20 min)
make dev-status # print service URLs and credentials
open http://localhost:8080After make dev-up completes you will have:
Service URL Credentials
--------- ---------------------------- -------------------------
Backstage http://localhost:8080 (open access)
ArgoCD http://localhost:8080/argocd admin / see dev-status
Grafana http://localhost:8080/grafana admin / fawkes-grafana
Sample app http://localhost:8080/podinfo (open access)
Run make dev-down to tear down the cluster when you are done.
→ For a full AWS production deployment, see docs/getting-started.md.
- Getting Started
- Architecture Overview
- Dojo Learning Environment
- Contributing Guide
- Coding Standards
- Troubleshooting
See ROADMAP.md for planned features.
Contributions are welcome — code, docs, dojo content, and bug reports.
- Read CONTRIBUTING.md and CODE_OF_CONDUCT.md.
- Browse good first issues.
- Set up pre-commit hooks:
make pre-commit-setup - Submit a pull request.
Questions? Start a GitHub Discussion.
Fawkes is licensed under the MIT License.