Kube Green

A K8s operator to reduce CO2 footprint of your clusters
Alternatives To Kube Green
Project NameStarsDownloadsRepos Using ThisPackages Using ThisMost Recent CommitTotal ReleasesLatest ReleaseOpen IssuesLicenseLanguage
Minio41,9572012911 hours ago377December 01, 202343agpl-3.0Go
High Performance Object Storage for AI
13 hours ago95apache-2.0Lua
🦍 The Cloud-Native API Gateway
Lens21,810296 days ago21May 26, 20231,000otherTypeScript
Lens - The way the world runs Kubernetes
Harbor21,3122421 hours ago256November 30, 2023592apache-2.0Go
An open source trusted cloud native registry project that stores, signs, and scans content.
Jina19,4031615 hours ago2,453December 01, 202318apache-2.0Python
☁️ Build multimodal AI applications with cloud-native stack
Argo Workflows13,766245113 hours ago449November 27, 2023968apache-2.0Go
Workflow Engine for Kubernetes
a day ago127April 23, 2021415apache-2.0Go
The container platform tailored for Kubernetes multi-cloud, datacenter, and edge management ⎈ 🖥 ☁️
13 hours ago491apache-2.0Lua
The Cloud-Native API Gateway
Quarkus12,5962011 hours ago263November 22, 20232,472apache-2.0Java
Quarkus: Supersonic Subatomic Java.
Rook11,5882212 hours ago310December 01, 2023155apache-2.0Go
Storage Orchestration for Kubernetes
Alternatives To Kube Green
Select To Compare

Alternative Project Comparisons

Go Report Card Coverage Security Coverage Status Documentations Adopters

Dark kube-green logo

How many of your dev/preview pods stay on during weekends? Or at night? It's a waste of resources! And money! But fear not, kube-green is here to the rescue.

kube-green is a simple k8s addon that automatically shuts down (some of) your resources when you don't need them.

If you already use kube-green, add you as an adopter!

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See how to install the project on a live system in our docs.


Make sure you have Go installed (download). Version 1.19 or higher is required.


To have kube-green running locally just clone this repository and install the dependencies running:

go get

Running the tests

There are different types of tests in this repository.

It is possible to run all the unit tests with

make test

To run integration tests:

make e2e-test


To deploy kube-green in live systems, follow the docs.

To run kube-green for development purpose, you can use ko to deploy in a KinD cluster. It is possible to start a KinD cluster running kind create cluster --name kube-green-development. To deploy kube-green using ko, run:

make local-run clusterName=kube-green-development


The use of this operator is very simple. Once installed on the cluster, configure the desired CRD to make it works.

See here the documentation about the configuration of the CRD.

CRD Examples

Pods running during working hours with Europe/Rome timezone, suspend CronJobs and exclude a deployment named api-gateway:

apiVersion: kube-green.com/v1alpha1
kind: SleepInfo
  name: working-hours
  weekdays: "1-5"
  sleepAt: "20:00"
  wakeUpAt: "08:00"
  timeZone: "Europe/Rome"
  suspendCronJobs: true
    - apiVersion: "apps/v1"
      kind:       Deployment
      name:       api-gateway

Pods sleep every night without restore:

apiVersion: kube-green.com/v1alpha1
kind: SleepInfo
  name: working-hours-no-wakeup
  sleepAt: "20:00"
  timeZone: Europe/Rome
  weekdays: "*"

To see other examples, go to our docs.


Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.


We use SemVer for versioning. For the versions available, see the release on this repository.

How to upgrade the version

To upgrade the version:

  1. make release version=v{{NEW_VERSION_TO_TAG}} where {{NEW_VERSION_TO_TAG}} should be replaced with the next version to upgrade. N.B.: version should include v as first char.
  2. git push --tags origin v{{NEW_VERSION_TO_TAG}}

API Reference documentation

API reference is automatically generated with this tool. To generate it automatically, are added in api versioned folder a file doc.go with the content of file groupversion_info.go and a comment with +genclient in the sleepinfo_types.go file for the resource type.


This project is licensed under the MIT License - see the LICENSE file for details


Special thanks to JGiola for the tech review.

Give a Star!

If you like or are using this project, please give it a star. Thanks!


Here the list of adopters of kube-green.

If you already use kube-green, add you as an adopter!

Popular Kubernetes Projects
Popular Cloud Native Projects
Popular Virtualization Categories
Related Searches

Get A Weekly Email With Trending Projects For These Categories
No Spam. Unsubscribe easily at any time.
Cloud Native