Quick Start
Chomper deploys as a single Docker Compose stack — Fastify ingestion, a Redis queue, a Python worker, ClickHouse, and the Next.js UI, all wired together for you. Getting a box ready takes two steps:
- Install Docker and the Docker Compose plugin (this page — pick your OS below).
- Run the one-line install command from your personal cabinet → Servers → Install on the target machine. It downloads the compose file (with your license key already baked in), brings the stack up, waits for it to become healthy, and prints the URL and the generated admin login.
Step 2 is a single curl | sh command generated per-server in your cabinet — there's nothing to configure by hand. This page is only about step 1: getting Docker itself onto a fresh machine.
Pick your OS
Already have Docker running? Skip straight to step 2 — open your Servers tab and click Install on the server you want to deploy to.
Minimum requirements
| Resource | Minimum |
|---|---|
| RAM | 2 GB (ClickHouse + Redis + Node/Python services) |
| Disk | 10 GB free, more if you plan to retain events long-term |
| OS | Any 64-bit Linux with a supported Docker Engine build, or macOS |
| Network | Outbound HTTPS (pulls images from the Chomper registry, pings licensing) |
Last updated 14 July 2026