uptrakit

Deployment Guides

  • Overview— Deployment guides for running Uptrakit behind a reverse proxy, covering proxy modes, Docker Compose, external scheduler, and NATS HA setups.
  • Reverse Proxy Deployment Guide— Covers L4 TCP passthrough and L7 TLS termination modes, controller trusted-proxy settings, and client certificate forwarding requirements.
  • Nginx Reverse Proxy— Configuration examples for Nginx as a reverse proxy in both L4 TLS passthrough and L7 TLS termination modes with client certificate forwarding.
  • Nginx Proxy Manager— Configure Nginx Proxy Manager via its web GUI for basic L7 reverse proxying and advanced client certificate forwarding to the controller.
  • Traefik Reverse Proxy— Configuration examples for Traefik in L4 TLS passthrough and L7 TLS termination modes with Docker Compose labels and header forwarding.
  • Caddy Reverse Proxy— Configuration examples for Caddy as a reverse proxy using the layer4 plugin for TCP passthrough or HTTP termination with PEM header handling.
  • Envoy Reverse Proxy— Configuration examples for Envoy in L4 TCP passthrough and L7 TLS termination modes with XFCC header forwarding to the controller.
  • HAProxy Reverse Proxy— Configuration examples for HAProxy in L4 TCP passthrough and L7 TLS termination modes with client certificate forwarding and CRL refresh strategy.
  • Proxmox VE Helper-Scripts— Install the uptrakit controller as an LXC container on Proxmox VE using a single command, with automatic updates via the PVEHS framework.
  • Docker Deployment— Run Uptrakit with Docker Compose using pre-built images from GHCR, covering quick-start setup, auto-enrollment, and optional service profiles.
  • External Scheduler Deployment— Deploy the uptrakit-scheduler binary as a standalone service for decoupled scheduling in multi-controller HA or single-controller setups with NATS.
  • NATS Deployment Guide— Deploy Uptrakit with NATS JetStream to enable real-time cross-controller push notifications in multi-controller high-availability setups.