Local Dashboard
Overview
Section titled “Overview”The dashboard is a single container (or binary) that renders Kubernetes + ECS cost data in real time. It never stores data permanently and only needs network access to the agents.
Run it anywhere
Section titled “Run it anywhere”docker run --rm -p 4173:4173 \ -e CLUSTERCOST_AGENT_URL="grpc://agent.clustercost.svc.cluster.local:9000" \ ghcr.io/clustercost/dashboard:latestAlternative options:
- Kubernetes: deploy as a Deployment/Service inside your cluster for shared access.
- ECS: run as a Fargate service and expose via an internal ALB.
- Binary: download the static build from the releases page when you need zero-container setups.
Connect to agents
Section titled “Connect to agents”Set one or more CLUSTERCOST_AGENT_URL values (comma-separated). The dashboard multiplexes across all configured agents and deduplicates workloads using namespaces, workloads, and tenant labels. Authentication is handled via mTLS when enabled in the agent chart; otherwise the connection remains inside your network boundary.