{"id":13550839,"url":"https://github.com/kubermatic/kubermatic","last_synced_at":"2026-03-02T22:17:49.955Z","repository":{"id":37394972,"uuid":"50734768","full_name":"kubermatic/kubermatic","owner":"kubermatic","description":"Kubermatic Kubernetes Platform - the Central Kubernetes Management Platform For Any Infrastructure ","archived":false,"fork":false,"pushed_at":"2025-05-12T12:51:08.000Z","size":172714,"stargazers_count":1145,"open_issues_count":367,"forks_count":172,"subscribers_count":20,"default_branch":"main","last_synced_at":"2025-05-12T13:49:44.543Z","etag":null,"topics":["cluster-api","kubermatic-kubernetes-platform","kubernetes"],"latest_commit_sha":null,"homepage":"https://www.kubermatic.com","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kubermatic.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2016-01-30T17:05:09.000Z","updated_at":"2025-05-12T13:01:09.000Z","dependencies_parsed_at":"2023-10-14T18:45:11.868Z","dependency_job_id":"3367d56e-d4cd-43f0-a6f1-65ff60a24672","html_url":"https://github.com/kubermatic/kubermatic","commit_stats":{"total_commits":6745,"total_committers":135,"mean_commits":49.96296296296296,"dds":0.8730911786508525,"last_synced_commit":"b19911909d8a137f7e8ff2fb9c7b202aff9757f2"},"previous_names":[],"tags_count":371,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kubermatic%2Fkubermatic","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kubermatic%2Fkubermatic/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kubermatic%2Fkubermatic/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kubermatic%2Fkubermatic/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kubermatic","download_url":"https://codeload.github.com/kubermatic/kubermatic/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254149953,"owners_count":22022851,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cluster-api","kubermatic-kubernetes-platform","kubernetes"],"created_at":"2024-08-01T12:01:38.360Z","updated_at":"2026-03-02T22:17:49.915Z","avatar_url":"https://github.com/kubermatic.png","language":"Go","funding_links":[],"categories":["Go","kubernetes","Dashboards \u0026 Portals","Cluster"],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/kkp-logo.png#gh-light-mode-only\" width=\"700px\" /\u003e\n  \u003cimg src=\"docs/kkp-logo-dark.png#gh-dark-mode-only\" width=\"700px\" /\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/v/release/kubermatic/kubermatic\" alt=\"last stable release\"\u003e\n\n  \u003ca href=\"https://goreportcard.com/report/k8c.io/kubermatic/v2\"\u003e\n    \u003cimg src=\"https://goreportcard.com/badge/k8c.io/kubermatic/v2\" alt=\"go report card\"\u003e\n  \u003c/a\u003e\n\n  \u003ca href=\"https://pkg.go.dev/k8c.io/kubermatic/v2\"\u003e\n    \u003cimg src=\"https://pkg.go.dev/badge/k8c.io/kubermatic/v2\" alt=\"godoc\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n## Overview / User Guides\n\nKubermatic 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.\n\nAll user documentation is available at the [Kubermatic Kubernetes Platform docs website][21].\n\n## Editions\n\nThere are two editions of Kubermatic Kubernetes Platform:\n\nKubermatic Kubernetes Platform Community Edition (CE) is available freely under the Apache License, Version 2.0.\nKubermatic 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.\n\n## Licensing\n\nSee the [LICENSE](LICENSE) file for licensing information as it pertains to files in this repository.\n\n## Installation\n\nWe strongly recommend that you use an official release of Kubermatic Kubernetes Platform. Follow the instructions under the **Installation** section of [our documentation][21] to get started.\n\n_The code and sample YAML files in the main branch of the kubermatic repository are under active development and are not guaranteed to be stable. Use them at your own risk!_\n\n## More information\n\n[The documentation][21] provides a getting started guide, plus information about building from source, architecture, extending kubermatic, and more.\n\nPlease use the version selector at the top of the site to ensure you are using the appropriate documentation for your version of kubermatic.\n\n## Troubleshooting\n\nIf you encounter issues [file an issue][1] or talk to us on the [#kubermatic channel][12] on the [Kubermatic Community Slack][15] ([click here to join][16]).\n\n## Contributing\n\nThanks for taking the time to join our community and start contributing!\n\n### Before you start\n\n* Please familiarize yourself with the [Code of Conduct][4] before contributing.\n* See [CONTRIBUTING.md][2] for instructions on the developer certificate of origin that we require.\n\n### Repository layout\n\n```\n├── addons    # Default Kubernetes addons\n├── charts    # The Helm charts we use to deploy\n├── cmd       # Various Kubermatic binaries for the controller-managers, operator etc.\n├── codegen   # Helper programs to generate Go code and Helm charts\n├── docs      # Some basic developer-oriented documentation\n├── hack      # scripts for development and CI\n└── pkg       # most of the actual codebase\n```\n\n### Development environment\n\n```bash\ngit clone git@github.com:kubermatic/kubermatic.git\ncd kubermatic\n```\n\nThere are a couple of scripts in the `hacks` directory to aid in running the components locally\nfor testing purposes.\n\n#### Running components locally\n\n##### user-cluster-controller-manager\n\nIn order to instrument the seed-controller to allow for a local user-cluster-controller-manager, you need to add a `worker-name` label with your local machine's name as its value. Additionally, you need to scale down the already running deployment.\n\n```sh\n# Using a kubeconfig, which points to the seed-cluster\nexport cluster_id=\"\u003cid-of-your-user-cluster\u003e\"\nkubectl label cluster ${cluster_id} worker-name=$(uname -n)\nkubectl scale deployment -n cluster-${cluster_id} usercluster-controller --replicas=0\n```\n\nAfterwards, you can start your local user-cluster-controller-manager.\n\n```sh\n# Using a kubeconfig, which points to the seed-cluster\n./hack/run-user-cluster-controller-manager.sh\n```\n\n##### seed-controller-manager\n\n```bash\n./hack/run-seed-controller-manager.sh\n```\n\n##### master-controller-manager\n\n```bash\n./hack/run-master-controller-manager.sh\n```\n\n#### Run linters\n\nBefore every push, make sure you run:\n\n```bash\nmake lint\n```\n#### Run tests\n\n```bash\nmake test\n```\n\n#### Update code generation\n\nThe Kubernetes code-generator tool does not work outside of `GOPATH`\n([upstream issue](https://github.com/kubernetes/kubernetes/issues/86753)), so the script\nbelow will automatically run the code generation in a Docker container.\n\n```bash\nhack/update-codegen.sh\n```\n\n### Pull requests\n\n* We welcome pull requests. Feel free to dig through the [issues][1] and jump in.\n\n## Changelog\n\nSee [the list of releases][3] to find out about feature changes.\n\n[1]: https://github.com/kubermatic/kubermatic/issues\n[2]: https://github.com/kubermatic/kubermatic/blob/main/CONTRIBUTING.md\n[3]: https://github.com/kubermatic/kubermatic/releases\n[4]: https://github.com/kubermatic/kubermatic/blob/main/CODE_OF_CONDUCT.md\n\n[12]: https://kubermatic-community.slack.com/messages/kubermatic\n[15]: http://kubermatic-community.slack.com\n[16]: https://join.slack.com/t/kubermatic-community/shared_invite/zt-vqjjqnza-dDw8BuUm3HvD4VGrVQ_ptw\n\n[21]: https://docs.kubermatic.com/kubermatic/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkubermatic%2Fkubermatic","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkubermatic%2Fkubermatic","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkubermatic%2Fkubermatic/lists"}