Getting started
Run TestGator on your own infrastructure
TestGator ships as two Docker images — a client and a server — with published, step-by-step guides for each deployment target in the main repository. Pick the one that matches your setup below.
Browse the full docs on GitHub →🐳
Single-node Docker
The simplest path: one server, plain Docker Compose, and a small Caddy container that handles HTTPS for you automatically.
- Good for small teams
- One machine, no orchestration
- Free automatic HTTPS
🐙
Docker Swarm
Run TestGator across a Swarm cluster with rolling updates and Docker secrets for the signing key.
- Multiple replicas
- Zero-downtime updates
- Built-in clustering
☸
Kubernetes
Deploy with plain Kubernetes manifests — Deployments, Services, and an Ingress for TLS.
- Production-grade scaling
- Works with any ingress controller
- Secrets-based key management
Contributing
Local development
Working on TestGator itself, or just want to try it without deploying anywhere? Clone both repos and run them locally.
Server
cp .env .env.local # then edit secrets make up # docker compose up, dev image with hot reload
