Getting Started

Start here if you are new to Joulie.

Prerequisites: Kubernetes 1.26+, Helm 3+, and cluster-admin access. For GPU support, nodes must have NVIDIA drivers with NVML available.

This section is ordered intentionally:

1. Core Concepts - what Joulie is, how the control loop works
2. Quickstart - install and verify
3. Pod Compatibility - workload class annotations and scheduling behavior
4. Agent Runtime Modes - DaemonSet, pool and emulated modes
5. Configuration Reference - all environment variables
6. Upgrading - what to check before upgrading an installation

By the end, you should understand:

• what controller manager, agent, and scheduler extender each do,
• how workload placement intent is expressed via pod annotations,
• how to configure and run Joulie in real-node and simulator workflows.

Once installed, use kubectl joulie (the kubectl plugin) for a per-node overview of power, power profiles, applied caps and digital twin scores, and kubectl joulie top for the live dashboard.