Skip to content

Claritools

Claritools is the internal development environment and multi-dev server toolkit for Clarity Innovations. It provides automatic HTTPS reverse proxying via Traefik so developers don't have to worry about port conflicts or certificate management. Add a few labels to your Docker Compose file and your service gets a clean HTTPS URL on the dashboard.

What it does

  • Automatic HTTPS for every service via Traefik reverse proxy
  • Service dashboard with auto-discovery via Homepage
  • Container monitoring with Prometheus and cAdvisor
  • Three operating modes tailored to different use cases

Operating modes

Mode Purpose URL pattern TLS
Local Develop Docker-based applications locally *.local.ciservers.net Self-signed
Dev Develop and test claritools itself, including OIDC auth *.local.ciservers.net Self-signed
CD Production multi-dev server on the public internet *.cd.ciservers.net Let's Encrypt

Quick start

git clone git@git.clarity-innovations.com:internal/claritools.git
cd claritools
task init
task generate-local-self-signed-certs  # local and dev only
task start

See Getting Started for detailed setup instructions.