Red Hat Summit Red Hat SummitSupportConsoleDevelopersStart a trialContact

Red Hat build of MicroShift release notes

Red Hat build of MicroShift 4.18

Highlights of what is new and what has changed with this MicroShift release

Red Hat OpenShift Documentation Team

Abstract

The release notes for MicroShift summarize all new features and enhancements, notable technical changes, major corrections from the previous version, and any known bugs.

Red Hat build of MicroShift (MicroShift) provides developers and IT organizations with small-form-factor and edge computing delivered as an application that customers can deploy on top of their managed Red Hat Enterprise Linux (RHEL) devices at the edge. Built on OpenShift Container Platform and Kubernetes, MicroShift provides an efficient way to operate single-nodes in low-resource edge environments.

1.1. About this release
Copy link

MicroShift is designed to make control plane restarts economical and be lifecycle-managed as a single unit by the operating system. Updates, roll-backs, and configuration changes consist of simply staging another version in parallel and then - without relying on a network - flipping to and from that version and restarting.

Version 4.18 of MicroShift includes new features and enhancements. Update to the latest version of MicroShift to receive all of the latest features, bug fixes, and security updates. MicroShift is derived from OpenShift Container Platform 4.18 and uses the CRI-O container runtime. New features, changes, and known issues that pertain to MicroShift are included in this topic.

You can deploy a MicroShift node to on-premise, cloud, disconnected, and offline environments.

MicroShift 4.18 is supported on Red Hat Enterprise Linux (RHEL) 9.4.

For lifecycle information, see the Red Hat build of MicroShift Life Cycle Policy.

1.2. New features and enhancements
Copy link

This release adds improvements related to the following components and concepts.

1.2.1. Updating
Copy link

Updating two minor EUS versions in a single step is supported in 4.18. Updates for both single-version minor releases and patch releases are also supported. See Update options with Red Hat build of MicroShift and Red Hat Device Edge for details.

With this release, make configuring your MicroShift instances easier by using drop-in configuration snippets. See Using configuration snippets for details.

With this update, you have greater control over ingress to your MicroShift node by configuring more parameters. You can use these parameters to define secure connections and the number of connections per pod, plus more. See Using ingress control for a MicroShift node for details.

With this release, you can delete or upgrade the Kustomize manifest resources. For more information, see Deleting or updating Kustomize manifest resources.

With this release, you can see detailed explanations and example outputs to check whether greenboot workload scripts are running properly. For more information, see Testing a workload health check script.

1.2.6. Automated recovery from manual backups
Copy link

With this release, you can automatically restore data from manual backups when MicroShift fails to start by using the auto-recovery feature. For more information, see Automated recovery from manual backups.

1.3. Technology Preview features
Copy link

Some features in this release are currently in Technology Preview. These experimental features are not intended for production use. Note the following scope of support on the Red Hat Customer Portal for these features:

Technology Preview Features Support Scope

  • You can install MicroShift using a bootc container image. Image mode for RHEL is a Technology Preview deployment method that uses a container-native approach to build, deploy and manage the operating system as a bootc container image.

    See Using image mode for RHEL with MicroShift for more information.

1.4. Documentation enhancements
Copy link

You can also benefit by using the following documentation enhancements.

With this release, the contents of the "Installing with RHEL image mode" section, which were previously developer-focused, are now updated to be MicroShift administrator-focused. For more information, see Understanding image mode for RHEL with MicroShift.

1.5. Deprecated and removed features
Copy link

Learn about deprecated and removed features in MicroShift 4.18.

1.5.1. CSI snapshot webhook removed
Copy link

With this release, the CSI snapshot webhook feature available in previous releases is removed. The webhook is replaced by CEL validation rules for snapshot objects.

1.6. Bug fixes
Copy link

Learn about the bug fixes included in this release.

  • Previously, the greenboot health check marked some healthy Image mode for RHEL systems as unhealthy due to a 300-second timeout, which was insufficient for systems with slow networks. Beginning in Red Hat build of MicroShift 4.18, the default greenboot wait timeout has been extended to 600 seconds to provide more time to download images and ensure accurate system checks. (OCPBUGS-47463)

1.7. Additional release notes
Copy link

Release notes for related components and products are available in the following documentation:

Note

The following release notes are for downstream Red Hat products only; upstream or community release notes for related products are not included.

1.7.1. GitOps release notes
Copy link

See Red Hat OpenShift GitOps: Highlights of what is new and what has changed with this OpenShift GitOps release for more information. You can also go to the Red Hat package download page and search for "gitops" if you just need the latest package, Red Hat packages.

1.7.2. OpenShift Container Platform release notes
Copy link

See the OpenShift Container Platform Release Notes for information about the Operator Lifecycle Manager and other components. Not all of the changes to OpenShift Container Platform apply to MicroShift. See the specific MicroShift implementation of an Operator or function for more information.

See the Release Notes for Red Hat Enterprise Linux 9.4 for more information about RHEL.

1.8. Asynchronous errata updates
Copy link

Security, bug fix, and enhancement updates for MicroShift 4.18 are released as asynchronous errata through the Red Hat Network. All MicroShift 4.18 errata are available on the Red Hat Customer Portal. For more information about asynchronous errata, read the MicroShift Life Cycle.

Red Hat Customer Portal users can enable errata notifications in the account settings for Red Hat Subscription Management (RHSM). When errata notifications are enabled, you are notified through email whenever new errata relevant to your registered systems are released.

Note

Red Hat Customer Portal user accounts must have systems registered and consuming MicroShift entitlements for MicroShift errata notification emails to generate.

This section is updated over time to provide notes on enhancements and bug fixes for future asynchronous errata releases of MicroShift 4.18. Versioned asynchronous releases, for example with the form MicroShift 4.18.z, are detailed in the following subsections. MicroShift uses a priority-based release cadence to provide the most important updates with the least disruption.

Important

For any Red Hat build of MicroShift release, always review the Update options with Red Hat build of MicroShift and Red Hat Device Edge documentation before proceeding with an update.

Issued: 25 February 2025

Red Hat build of MicroShift release 4.18.1 is now available. Bug fixes and enhancements are listed in the RHEA-2024:6124 advisory. Release notes for bug fixes and enhancements are provided in this documentation. The images that are included in the update are provided by the OpenShift Container Platform RHSA-2024:6122 advisory.

See the latest images included with MicroShift by listing the contents of the MicroShift RPM release package.

1.8.1.1. Known issue
Copy link
  • A failed greenboot health check flag does not clear when an RPM-install-based MicroShift service is updated without rebooting the system. As a consequence, greenboot health checks for optional components continue to fail because the systemctl restart greenboot-healthcheck.service command fails while the flag is present. (OCPBUGS-51198)

Issued: 4 March 2025

Red Hat build of MicroShift release 4.18.2 is now available. Bug fixes and enhancements are listed in the RHBA-2025:1953 advisory. Release notes for bug fixes and enhancements are provided in this documentation. The images that are included in the update are provided by the OpenShift Container Platform RHBA-2025:1904 advisory.

See the latest images included with MicroShift by listing the contents of the MicroShift RPM release package.

1.8.2.1. Bug fix
Copy link
  • Previously, a failed greenboot health check flag did not clear when an RPM-install-based MicroShift service was updated without rebooting the system. As a consequence, greenboot health checks for optional components continue to fail because the systemctl restart greenboot-healthcheck.service command fails while the flag is present. With this release, the primary MicroShift greenboot health check clears the condition that causes optional component health checks to continue to fail. (OCPBUGS-51198)

Issued: 1 May 2025

Red Hat build of MicroShift release 4.18.11 is now available, see the RHBA-2025:4249 advisory. Release notes for bug fixes and enhancements are provided in this documentation. The images that are included in the update are provided by the OpenShift Container Platform RHSA-2025:4211 advisory.

See the latest images included with MicroShift by using the following instructions:

1.8.3.1. Bug fixes
Copy link
  • Previously, MicroShift could fail to start on a host without the hostname RPM package installed. With this release, the hostname RPM package is pulled as a dependency during installation. This change means that the hostname RPM package is now required when building the MicroShift system, preventing this type of startup failure. (OCPBUGS-54448)
  • In some cases, MicroShift did not start when using the default configuration file shipped in the MicroShift RPM because certain required values were missing. These values are now added to the default config.yaml file to avoid this problem and MicroShift starts as expected. (OCPBUGS-53026)
  • Previously, when embedding container images during a bootc build procedure, extended attributes were discarded, preventing the router pod from connecting to default haproxy ports. With this release, extended attributes are kept for container layers that are embedded into container images. As a result, the bootc container router pod starts normally. (OCPBUGS-42010)

Issued: 16 October 2026

Red Hat build of MicroShift release 4.18.26 is now available, see the RHBA-2025:17912 advisory. Release notes for bug fixes and enhancements are provided in this documentation. The images that are included in the update are provided by the OpenShift Container Platform RHSA-2025:17657 advisory.

See the latest images included with MicroShift by using the following instructions:

1.8.4.1. Bug fix
Copy link
  • Before this update, embedding container images into a bootc build could fail because HTTP proxy environment variables were defined in the bootc image. Proxy errors occurred during container image embedding and prevented successful builds. With this release, the bootc image no longer sets HTTP proxy environment variables, thereby eliminating the issue. As a result, you can now embed container images without encountering proxy errors. (OCPBUGS-61433)
1.8.4.2. Enhancements
Copy link
  • With this release, MicroShift uses OpenVSwitch (OVS) 3.5, keeping OVS synchronized with OVN-Kubernetes. (OCPBUGS-58139)
  • With this release, the microshift-release-info RPM now incudes example RHEL Kickstart files for RPM, RHEL for Edge and image mode for RHEL installation types. You can use the Kickstart immediately for a faster installation, or customize it with your requirements. (OCPBUGS-42864)

Issued: 25 March 2026

Red Hat build of MicroShift release 4.18.36 is now available. Bug fixes and enhancements are listed in the RHBA-2026:5750 advisory. Release notes for bug fixes and enhancements are provided in this documentation. The images that are included in the update are provided by the OpenShift Container Platform RHSA-2026:5133 advisory.

See the latest images included with MicroShift by using the following instructions:

1.8.5.1. Fixed issues
Copy link

There are no notable fixed issues in this release.

Legal Notice
Copy link

Copyright © Red Hat.
Except as otherwise noted below, the text of and illustrations in this documentation are licensed by Red Hat under the Creative Commons Attribution–Share Alike 3.0 Unported license . If you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, the Red Hat logo, JBoss, Hibernate, and RHCE are trademarks or registered trademarks of Red Hat, LLC. or its subsidiaries in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
XFS is a trademark or registered trademark of Hewlett Packard Enterprise Development LP or its subsidiaries in the United States and other countries.
The OpenStack® Word Mark and OpenStack logo are trademarks or registered trademarks of the Linux Foundation, used under license.
All other trademarks are the property of their respective owners.
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2026 Red HatBack to top