Probe Installation

Docker (Quickest)

docker run -d \
  -e GOVERN_API_KEY=your-api-key \
  -e GOVERN_ORG_ID=your-org-id \
  -e TARGET_URL=https://api.openai.com/v1/chat/completions \
  -p 9090:9090 -p 9091:9091 \
  archetypal/govern-probe:latest

Then point your application to http://localhost:9090 instead of the AI API directly.

Environment Variables

Variable	Required	Default	Description
`GOVERN_API_KEY`	Yes	—	API key from Settings > API Keys
`GOVERN_ORG_ID`	Yes	—	Organization ID
`TARGET_URL`	Yes	—	AI API endpoint to proxy
`PROBE_PORT`	No	`9090`	Proxy listen port
`PROBE_SCORING_MODE`	No	`log`	log / flag / block
`PROBE_TIMEOUT_MS`	No	`30000`	Request timeout

Kubernetes

apiVersion: apps/v1
kind: Deployment
metadata:
  name: govern-probe
spec:
  replicas: 1
  selector:
    matchLabels:
      app: govern-probe
  template:
    metadata:
      labels:
        app: govern-probe
    spec:
      containers:
        - name: probe
          image: archetypal/govern-probe:latest
          ports:
            - containerPort: 9090
            - containerPort: 9091
          env:
            - name: GOVERN_API_KEY
              valueFrom:
                secretKeyRef:
                  name: govern-secrets
                  key: api-key
            - name: TARGET_URL
              value: "http://ai-service:8080/v1/chat/completions"
          livenessProbe:
            httpGet:
              path: /healthz
              port: 9091
          readinessProbe:
            httpGet:
              path: /readyz
              port: 9091

Auto-Registration

On startup, the probe auto-registers with the GOVERN API via POST /api/govern/probe/register. This creates a system entry in the dashboard so you can see the probe’s telemetry immediately.