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
View guide
🐙

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
View guide

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
View guide

Contributing

Local development

Working on TestGator itself, or just want to try it without deploying anywhere? Clone both repos and run them locally.

Server

arkdevuk/testgator_server

cp .env .env.local   # then edit secrets
make up               # docker compose up, dev image with hot reload

Client

arkdevuk/testgator_client

npm install
npm run dev