MicroShift is a lightweight Kubernetes distribution built on OpenShift that targets edge computing and resource-constrained environments. Written primarily in Go, the project optimizes the full OpenShift/Kubernetes stack for small form factor deployments where traditional cloud-native infrastructure proves impractical. The repository serves as the primary development hub for MicroShift, with community builds and CI infrastructure managed there alongside comprehensive contributor documentation.
The core architecture packages a minimal OpenShift control plane and worker node into a single systemd service, embedding kube-apiserver, kube-controller-manager, kube-scheduler, kubelet, and OpenShift controllers as goroutines within one binary. Etcd runs as a separate managed process rather than being embedded. Infrastructure services including DNS, ingress routing, service certificate authority, OVN-Kubernetes CNI, and LVMS storage are deployed as workloads onto the cluster after the control plane initializes. Optional components such as OLM, Gateway API, cert-manager, and SR-IOV are delivered as separate RPM packages and auto-discovered through the manifest path system. MicroShift vendors OpenShift source code without modification, meaning each MicroShift release builds from identical content as the corresponding OpenShift release and follows the same versioning scheme.
The project's design explicitly addresses the operational and environmental challenges of edge deployment. MicroShift prioritizes frugal resource consumption across CPU, memory, network, and storage; tolerates severe networking constraints; enables secure, safe, and seamless updates without disrupting running workloads; and integrates cleanly with edge-optimized operating systems like RHEL for Edge. The distribution maintains a consistent development and management experience with standard OpenShift, allowing developers familiar with OpenShift to work with MicroShift without significant relearning. Beyond edge deployment, MicroShift serves use cases including Kubernetes application development on resource-constrained systems, scale testing, and provisioning of lightweight control planes.
Minimum system requirements are modest: x86_64 or aarch64 CPU architecture, Red Hat Enterprise Linux with Extended Update Support, 2 CPU cores, 2GB RAM, and 2GB free storage for MicroShift and container images. For production deployments, MicroShift runs on bare metal hardware or hypervisors certified for RHEL 9. The project maintains documentation for installation, configuration, and deployment across user and contributor folders, with additional resources available at microshift.io.
Common issue labels include tide/merge-blocker and lifecycle markers, suggesting active management of blocking issues and lifecycle tracking. The repository shares contributors with related projects including podman-desktop/podman-desktop, velero-io/velero, and vmware-tanzu/velero, indicating cross-project collaboration within the container and edge computing ecosystem.
