Documentation
Everything you need to self-host Muon — deploy, migrate and scale.
Where do I start with Muon?
Run docker compose up to try it locally, deploy to Kubernetes with Helm for production, and migrate an existing Umami install with the Umami-compatible endpoint.
Deploy, migrate and self-host.
Start with the guide that matches where you are — trying Muon out, moving to production, or bringing an existing Umami install with you.
Deploy → Docker
Stand up the full stack — backend, dashboard, tracker and PostgreSQL — with a single docker compose up. The fastest way to try Muon locally.
Docker guide →Deploy → Kubernetes
Run Muon in production with Helm. Stateless Rust backend nodes behind PostgreSQL, ingress, TLS and horizontal autoscaling.
Kubernetes guide →Migrate → Umami
Muon is Umami-compatible. Point your existing tracker at Muon's /api/send endpoint and import historical data — no tracking code rewrite.
Migrate from Umami →Benchmarks
How Muon compares to Umami on the same Umami-compatible endpoint and identical PostgreSQL setup — throughput, latency, memory and image size.
Muon vs Umami →GitHub
Backend, dashboard, tracker and the benchmark harness — all open source. Read the code, file issues, and star the project.
View on GitHub →More guides on the way.
These are planned — not yet published.
Start with two commands.
Clone the repo, docker compose up, and open the dashboard. Everything you need to self-host is here.