Introduction

The agent is a lightweight Go binary that runs on every server in your cluster. It polls the control plane for expected state and reconciles containers, networking, and routing automatically.

​

Node Types

Each agent runs in one of two modes:

​

Proxy Node

• Runs Traefik for TLS termination.
• Receives Traefik routes from the control plane.
• Handles public traffic and routes requests to containers over WireGuard.
• Collects and ships Traefik access logs.

​

Worker Node

• Does not run Traefik.
• Receives empty Traefik route sets from the control plane.
• Skips Traefik-related drift detection and reconciliation.
• Keeps a lighter runtime footprint focused on container workloads.

​

Container Labels

The agent tracks managed containers with Podman labels: Containers without techulus.deployment.id are treated as orphans and cleaned up.

​

Command Line Flags