Skip to content
github-actions[bot] edited this page Nov 8, 2026 · 3 revisions

For operators running titanium-manager with Plus agents. Canonical how-to: Manager.

titanium-manager is a SQLite-backed control plane for Titanium fleets. Operators publish YAML revisions; Plus agents long-poll, apply, and ack or nack. The manager never pushes. v1 is single-instance only (no HA / multi-writer).

Quick start

titanium-manager --listen http://127.0.0.1:7700/ --db ./manager.db --admin-token <secret>

Bootstrap the admin token with --admin-token or TITANIUM_MANAGER_ADMIN_TOKEN. Agents enroll with plus.options manager.url and manager.tokenFile (see Plus).

The Helm chart is deploy/helm/titanium-manager (OCI oci://ghcr.io/justcoding121/charts/titanium-manager, and titanium-manager-1.0.1.tgz on the GitHub Release). One replica, SQLite on a PVC. GET /v1/healthz needs no token. GET /v1/fleets needs the bearer token from Secret <release>-titanium-manager-admin, key admin-token. image.tag defaults to the chart appVersion (8.0.1).

What it covers

  • Staged publish waves (matchLabels, maxUnavailable, bakeSeconds) with auto-pause and rollback
  • Last-known-good YAML on each agent when the manager is unreachable
  • GitOps via the publish API (no built-in git sync; agents pull)

Full tables and flags: titaniumproxy.com/docs/manager. Related: Capabilities, Features.

Clone this wiki locally