# A free and self-hosted PaaS for Kubernetes


![](https://github.com/kubero-dev/kubero/raw/main/docs/logo/kubero-logo-horizontal.png align="center")

Kubero \[pronounced: Kube Hero\] is a self-hosted PaaS (Platform as a Service) that allows any developer to deploy their application on Kubernetes without specialized knowledge. Kubero follows the principles of 12-factor apps. It is possible to run apps based on existing containers or from source code.  
  

[![](https://github.com/kubero-dev/kubero/raw/main/docs/screenshots/createapp.gif align="left")](https://github.com/kubero-dev/kubero/blob/main/docs/screenshots/createapp.gif)

More [Screenshots](https://docs.kubero.dev/screenshots) and a full video on [YouTube](https://www.youtube.com/watch?v=kmqhddc6UlI)

## How GitOps Works ([DEMO](https://demo.kubero.dev/))

1. Create a pipeline with the phases you need (review, test, stage, production)
    
2. (optional) Connect the pipeline to your git repository (Github, Bitbucket, Gitlab, Gitea, Gogs)
    
3. Configure your apps with cronjobs and addons
    

Kubero starts now building your app. Once the build is complete, Kubero will launch the final container and make it accessible via the configured domain.

## Features

* Create unlimited CI/CD pipelines with up to 4 separate **staging environments** for all your applications
    
* Automatically build, start, and cleanup **review-apps** after opening/closing a pull request
    
* Automatic **redeployment** of the app based on a push to a branch or tag
    
* Create scheduled tasks as **cronjobs**
    
* Deploy well known apps with **templates** [(WordPress, Grafana, ...)](https://www.kubero.dev/templates)
    
* Easy deployment of your docker containers on Kubernetes **without writing helm charts**
    
* Deploy **add-ons** along your application (PostgreSQL, Redis, [and more ...](https://github.com/kubero-dev/kubero#preconfigured-add-ons))
    
* Easy access of **application logs** in the web-UI
    
* Easy and safe **restart** of the application in the web-UI
    
* Triggered or periodic **vulnerability scans** of your running apps
    
* Comes with an **API and CLI** to integrate with your existing tools and CI/CD
    
* Built-in **container web console**
    
* Build and deployment **Notifications** to Discord/Slack/Webhooks
    
* Integrated **metrics and monitoring**
    
* **SSO** with Github and Oauth2
    

## Supported GIT repositories (hosted and self-hosted)

* Gitea / Forgejo
    
* Gogs
    
* Github
    
* Gitlab
    
* Bitbucket
    

## Tested languages/frameworks

Basically *everything* that can be packaged in a single container can be deployed by Kubero.

* GoLang (including Hugo, gin-gonic)
    
* Python (including Flask)
    
* JavaScript/NodeJS
    
* PHP (including Laravel)
    
* Ruby (including Rails)
    
* Static HTML
    
* Rust (including Rocket)
    
* ...
    

## Add-ons

|  | Addon | Maintainer | Built in\* |
| --- | --- | --- | --- |
|  | MySQL | [Bitnami](https://github.com/bitnami/charts/tree/main/bitnami/mysql) | ✅ |
|  | PostgreSQL | [Bitnami](https://github.com/bitnami/charts/tree/main/bitnami/postgresql) | ✅ |
|  | Redis | [Bitnami](https://github.com/bitnami/charts/tree/main/bitnami/redis) | ✅ |
|  | MongoDB | [Bitnami](https://github.com/bitnami/charts/tree/main/bitnami/mongodb) | ✅ |
|  | Elasticsearch | [Bitnami](https://github.com/bitnami/charts/tree/main/bitnami/elasticsearch) | ✅ |
|  | Kafka | [Bitnami](https://github.com/bitnami/charts/tree/main/bitnami/kafka) | ✅ |
|  | CouchDB | [Apache](https://apache.github.io/couchdb-helm) | ✅ |
|  | Haraka Mail Server | [Kubero](https://github.com/kubero-dev/haraka-docker) | ✅ |
|  | Memcache | [Bitnami](https://github.com/bitnami/charts/tree/main/bitnami/memcached) | ✅ |
|  | RabbitMQ | [Bitnami](https://github.com/bitnami/charts/tree/main/bitnami/rabbitmq) | ✅ |
|  | Cludflare Tunnels | [Adianth](https://github.com/adyanth/cloudflare-operator) |  |
|  | Minio | [Minio](https://artifacthub.io/packages/olm/community-operators/minio-operator) |  |
|  | Percona MongoDB Cluster | [Percona](https://artifacthub.io/packages/olm/community-operators/mongodb-operator) |  |
|  | Crunchy Postgres Cluster | [Crunchy Data](https://artifacthub.io/packages/olm/community-operators/postgresql) |  |
|  | Redis Cluster | [Opstree](https://artifacthub.io/packages/olm/community-operators/redis-operator) |  |
|  | CockroachDB | [CockroachDB](https://artifacthub.io/packages/olm/community-operators/cockroachdb) |  |

\* Ships with the Kubero Operator

## 80+ Application templates (similar to Heroku Buttons)

* WordPress
    
* Grafana
    
* Bitwarden
    
* [Kuma](https://uptime.kuma.pet/)
    
* [Trilium Notes](https://github.com/zadam/trilium)
    
* ...
    

Check out the full [list here](https://www.kubero.dev/templates/) or submit your own app! [Read here](https://github.com/kubero-dev/kubero/blob/main/services/) how to do it.

## Basic Concept

Kubero is Kubernetes native and runs with two containers on any Kubernetes instance (kubero-ui and Operator). All data is stored on your Kubernetes etcd without an extra database.  

[![](https://github.com/kubero-dev/kubero/raw/main/docs/img/highlevel.png align="left")](https://github.com/kubero-dev/kubero/blob/main/docs/img/highlevel.png)

## Quickstart

**1) Download and unpack the** [**Kubero CLI**](https://github.com/kubero-dev/kubero-cli/releases/latest) (MacOS, Linux, Windows)

Binaries (MacOS, Linux)

```basic
curl -fsSL get.kubero.dev | bash
```

Brew (MacOS, Linux)

```basic
brew tap kubero-dev/kubero
brew install kubero-cli
```

**2) Run** `kubero install` to install all components on a new or your existing cluster

You can bring your own existing cluster or create one with the kubero install on one of the following providers:

* GKE
    
* Scaleway
    
* DigitalOcean
    
* Linode
    
* Kind (local)
    

## Documentation

[https://docs.kubero.dev/](https://docs.kubero.dev/)

## Roadmap

[https://github.com/orgs/kubero-dev/projects/1/views/3](https://github.com/orgs/kubero-dev/projects/1/views/3)

## Community

[![kubero Discord server Banner](https://camo.githubusercontent.com/a362f17f7e51205d4a8067678a640fb1a48b4a03c2150e520a78ba545bf4e866/68747470733a2f2f646973636f72646170702e636f6d2f6170692f6775696c64732f313035313234393934373437323832363430382f7769646765742e706e673f7374796c653d62616e6e657232 align="left")](https://discord.gg/tafRPMWS4r)

## Contributing

All contributions are welcome!

* Rise an issue/bug/error
    
* Open a feature request
    
* Discuss ideas in the discussions section or discord
    
* Fix typos (I do a lot of them)
    
* Contribute code
    
* Write articles
    

## Supporting this project

Starring this project is a huge motivation. ⭐ Thank you!

[![Stargazers over time](https://camo.githubusercontent.com/099725d55cdc361816ec5dcd0a282efb060116dfb1c5c32ad1a294a4293598ee/68747470733a2f2f7374617263686172742e63632f6b756265726f2d6465762f6b756265726f2e737667 align="center")](https://starchart.cc/kubero-dev/kubero)