Skip to content
Branch: master
Go to file

Latest commit

lsviben committed a679921 Jul 8, 2020
* removed the seed representation in dc lists

* Removed LegacyObjectMeta in dc


Failed to load latest commit information.
Latest commit message
Commit time

Kubermatic Kubernetes Platform

Overview / User Guides

Kubermatic Kubernetes Platform is in an open source project to centrally manage the global automation of thousands of Kubernetes clusters across multicloud, on-prem and edge with unparalleled density and resilience.

All user documentation is available at the Kubermatic Kubernetes Platform docs website.


There are two editions of Kubermatic Kubernetes Platform:

Kubermatic Kubernetes Platform Community Edition (CE) is available freely under the Apache License, Version 2.0. Kubermatic Kubernetes Platform Enterprise Edition (EE) includes premium features that are most useful for organizations with large-scale Kubernetes installations with more than 50 clusters. To access the Enterprise Edition and get official support please become a subscriber.


See the LICENSE file for licensing information as it pertains to files in this repository.


We strongly recommend that you use an official release of Kubermatic Kubernetes Platform. Follow the instructions under the Installation section of our documentation to get started.

The code and sample YAML files in the master branch of the kubermatic repository are under active development and are not guaranteed to be stable. Use them at your own risk!

More information

The documentation provides a getting started guide, plus information about building from source, architecture, extending kubermatic, and more.

Please use the version selector at the top of the site to ensure you are using the appropriate documentation for your version of kubermatic.


If you encounter issues file an issue or talk to us on the #kubermatic channel on the Kubermatic Slack.


Thanks for taking the time to join our community and start contributing!

Feedback and discussion are available on the mailing list.

Before you start

Repository layout

├── addons            # Default Kubernetes addons
├──      # The changelog
├── cmd               # Various Kubermatic binaries for the API, controller-managers etc.
├── codegen           # Helper programs to generate Go code and Helm charts
├── charts            # The Helm charts we use to deploy, gets exported to
├── containers        # Various utility container images
├── docs              # Some basic docs
├── hack              # scripts for development and CI
├── openshift_addons  # Default Openshift addons
├── pkg               # most of the actual codebase
├── Procfile

Development environment

mkdir -p $(go env GOPATH)/src/
cd $(go env GOPATH)/src/
git clone
cd kubermatic

There are a couple of scripts in the hacks directory to aid in running the components locally for testing purposes.

You can create a cluster via the UI at, then use kubectl to add a worker-name=<<hostname-of-your-laptop>> label to the cluster. This will make your locally running controlers manage the cluster.

Running locally


Run linters

Before every push, make sure you run:

make check

gofmt errors can be automatically fixed by running

make fix

Run tests

make test

Update dependencies

Sure that you want to update? And not just install dependencies?

dep ensure -update

Update code generation


Pull requests

  • We welcome pull requests. Feel free to dig through the issues and jump in.


See the list of releases to find out about feature changes.


The Central Kubernetes Management Platform For Any Infrastructure




You can’t perform that action at this time.