https://github.com/rancher/elemental
Elemental is a software stack enabling centralized, full cloud-native OS management with Kubernetes.
https://github.com/rancher/elemental
containers docker kubernetes rancher
Last synced: 6 months ago
JSON representation
Elemental is a software stack enabling centralized, full cloud-native OS management with Kubernetes.
- Host: GitHub
- URL: https://github.com/rancher/elemental
- Owner: rancher
- License: apache-2.0
- Created: 2022-01-19T08:09:41.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2025-04-29T15:58:54.000Z (6 months ago)
- Last Synced: 2025-04-29T16:49:35.834Z (6 months ago)
- Topics: containers, docker, kubernetes, rancher
- Language: Go
- Homepage: https://elemental.docs.rancher.com/
- Size: 23.5 MB
- Stars: 334
- Watchers: 15
- Forks: 39
- Open Issues: 95
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Codeowners: CODEOWNERS
Awesome Lists containing this project
README
# Elemental
See [here](.github/workflows/README.md) for a detailed view of the tests scheduling.
[](https://github.com/rancher/elemental/actions/workflows/lint.yaml)
[](https://github.com/rancher/elemental/actions/workflows/cli-k3s-matrix.yaml)
[](https://github.com/rancher/elemental/actions/workflows/cli-k3s-upgrade-matrix.yaml)
[](https://github.com/rancher/elemental/actions/workflows/cli-rke2-matrix.yaml)
[](https://github.com/rancher/elemental/actions/workflows/cli-rke2-upgrade-matrix.yaml)
[](https://github.com/rancher/elemental/actions/workflows/ui-k3s-matrix.yaml)
[](https://github.com/rancher/elemental/actions/workflows/ui-k3s-upgrade-matrix.yaml)
[](https://github.com/rancher/elemental/actions/workflows/ui-rke2-matrix.yaml)
[](https://github.com/rancher/elemental/actions/workflows/ui-rke2-upgrade-matrix.yaml)
[](https://github.com/rancher/elemental/actions/workflows/cli-full-backup-restore-matrix.yaml)
[](https://github.com/rancher/elemental/actions/workflows/cli-k3s-airgap-matrix.yaml)
[](https://github.com/rancher/elemental/actions/workflows/cli-regression-matrix.yaml)
## Goal
Elemental is a software stack enabling a centralized, full cloud-native OS management solution with Kubernetes.
Cluster Node OSes are built and maintained via container images through the [Elemental Toolkit](https://rancher.github.io/elemental-toolkit/) and installed on new hosts using the [Elemental CLI](https://github.com/rancher/elemental-cli).
The [Elemental Operator](https://github.com/rancher/elemental-operator) and the [Rancher System Agent](https://github.com/rancher/system-agent) enable Rancher Manager to fully control Elemental clusters, from the installation and management of the OS on the Nodes to the provisioning of new K3s or RKE2 clusters in a centralized way.
Follow our [Quickstart](https://rancher.github.io/elemental/quickstart/) or see the [full docs](https://rancher.github.io/elemental/) for more info.
## License
Copyright (c) 2020-2025 [SUSE, LLC](http://suse.com)
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
[http://www.apache.org/licenses/LICENSE-2.0](http://www.apache.org/licenses/LICENSE-2.0)
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.