Pi Controller Configuration Guide

Unified configuration system for all deployment modes

Table of contents

1. Configuration Precedence
2. Quick Start
   1. Binary Deployment
   2. Environment Variables
   3. Kubernetes
3. Configuration Files
4. Key WebUI Settings

---

This guide covers the unified configuration system supporting binary, Docker, and Kubernetes deployments.

Configuration Precedence

1. CLI Flags (highest)
2. Environment Variables
3. ConfigMap/CRD (K8s only)
4. YAML File
5. Defaults (lowest)

Quick Start

Binary Deployment

pi-controller -c config.yaml --webui-enabled --webui-port 3000

Environment Variables

export PI_CONTROLLER_WEBUI_PORT=3000
export PI_CONTROLLER_WEBUI_BACKEND_API_URL=http://localhost:8080

Kubernetes

kubectl apply -f config/crd/picontrollerwebui-crd.yaml
kubectl apply -f config/examples/picontrollerwebui-example.yaml

Configuration Files

• Example YAML: config/pi-controller.example.yaml
• CRD Definition: config/crd/picontrollerwebui-crd.yaml
• Examples: config/examples/picontrollerwebui-example.yaml

Key WebUI Settings

• webui.enabled: Enable/disable WebUI server
• webui.port: WebUI server port (default: 3000)
• webui.backend.api.url: Backend API URL
• webui.features.*: Feature flag toggles
• webui.branding.*: UI customization

See example files for complete reference.