GreenKube — FinGreenOps for Kubernetes

---

🎯 Why GreenKube?

Whether you’re a startup running a single cluster or a growing company scaling across regions, you deserve visibility into what your infrastructure really costs — not just in dollars, but in carbon.

GreenKube combines FinOps (cost optimization) with GreenOps (carbon reduction) into a single, open-source platform. It helps teams understand their energy consumption, identify waste, and take action — all without complex setup or expensive SaaS tools. For companies subject to the EU’s CSRD reporting requirements, GreenKube also provides the data you need for ESRS E1 compliance.

📊

Real-time Dashboard

Modern SvelteKit dashboard with interactive charts, per-pod metrics, node inventory, and optimization recommendations — all served from a single container.

Learn more →

🌍

Carbon Tracking

Converts energy consumption to CO₂e emissions using real-time grid carbon intensity data from Electricity Maps, supporting CSRD/ESRS E1 reporting requirements.

Learn more →

💰

Cost Optimization

Identifies zombie pods, oversized workloads, and autoscaling opportunities with estimated savings in both cost and carbon emissions.

Learn more →

🔧

Easy Deployment

Production-ready Helm chart with PostgreSQL, auto-discovery of Prometheus and OpenCost, RBAC, and health probes. Deploy in minutes.

Learn more →

---

⚡ Key Features

🔍

Multi-Resource Monitoring

Track CPU, memory, network I/O, disk I/O, storage, pod restarts, and GPU usage across your entire cluster.

Learn more →

🧠

Smart Recommendations

AI-powered analysis detects zombie pods, rightsizing opportunities, autoscaling candidates, and carbon-aware scheduling.

Learn more →

🗄️

Flexible Storage

Supports PostgreSQL (production), SQLite (development), and Elasticsearch (scale) — choose the backend that fits your needs.

Learn more →

☁️

Multi-Cloud Support

Built-in profiles for AWS, GCP, Azure, OVH, and Scaleway with automatic region-to-carbon-zone mapping.

Learn more →

📈

Historical Analysis

Report on any time period with flexible grouping (daily, monthly, yearly). Export to CSV or JSON for BI integration.

Learn more →

🚀

REST API

Full-featured FastAPI backend with OpenAPI docs, CORS support, and comprehensive endpoints for all metrics.

Learn more →

---

🏗️ Architecture at a Glance

GreenKube follows a clean, hexagonal architecture. Here’s how data flows through the system:

Data Collection Async

🔥

Prometheus

CPU, Memory, Network, Disk

☸️

Kubernetes

Nodes, Pods, HPAs

💲

OpenCost

Cost Data

⚡

Electricity Maps

CO₂ Intensity

▼

Processing Engine

⚙️

Data Processor

asyncio.gather orchestration

▼

🔋

Energy Estimator

Joules per pod

🗺️

Zone Mapper

Region → Carbon Zone

🌿

Carbon Calculator

kWh × gCO₂/kWh

▼

📦

Combined Metrics

Energy + Carbon + Cost per pod

▼

Output Layer

🗄️

Storage

PostgreSQL · SQLite · Elasticsearch

🚀

REST API

FastAPI + OpenAPI

🧠

Recommender

Optimization Analysis

▼

Presentation

📊

Web Dashboard

SvelteKit SPA

💻

CLI Reports

Typer + Rich

📄

CSV / JSON Export

BI Integration

Learn more about the architecture →

---

🚀 Quick Install

Get GreenKube running in your Kubernetes cluster in under 5 minutes:

# Add the Helm repository
helm repo add greenkube https://GreenKubeCloud.github.io/GreenKube
helm repo update

# Install GreenKube
helm install greenkube greenkube/greenkube \
  -n greenkube --create-namespace

# Access the dashboard
kubectl port-forward svc/greenkube-api 8000:8000 -n greenkube

Then open http://localhost:8000 in your browser.

Full installation guide →

---

🤝 Community & Contributors

GreenKube is an open-source, community-driven project. We welcome contributions of all kinds!

Hugo Lelievre

Creator & Lead Developer

⭐ Star on GitHub🤝 Contribute📧 Contact Us

---

📊 Project Stats

v0.2.0

Latest Version

5

Cloud Providers

293+

Unit Tests

3

Storage Backends

Apache 2.0

License

∞

kgCO₂ Saved