Red Hat Summit Red Hat SummitSupportConsoleDevelopersStart a trialContact

Red Hat build of MicroShift release notes

Red Hat build of MicroShift 4.20

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 a single node 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.20 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.20 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.20 is supported on Red Hat Enterprise Linux (RHEL) 9.6.

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

1.1.1. Updating
Copy link

Updating two minor EUS versions in a single step is supported in 4.20. 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.

1.2. New features and enhancements
Copy link

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

With this release, you can configure custom error code pages and logging parameters in the router, and you can capture HTTP headers and cookies in the ingress controller access logs. For more information, see Using ingress control for a MicroShift node.

With this release, MicroShift users can securely manage certificates for their components by using the cert-manager Operator. This enhancement automates the issuance and renewal of SSL/TLS certificates, enhancing data protection and ensuring regulatory compliance. It enables standardized certificate management, enhances node security, and results in more secure and standardized communication within and between user services. For more information, see cert-manager Operator for Red Hat OpenShift.

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

1.3.1. Generic Device Plugin feature
Copy link

The Generic Device Plugin (GDP) is a Kubernetes device plugin that enables applications running in pods to access host devices such as serial ports, cameras, and sound cards securely. This Technology Preview capability is especially important for edge and IoT environments where direct hardware interaction is a common requirement. The GDP integrates with the kubelet to advertise available devices to the node and facilitate their allocation to pods without requiring elevated privileges within the container itself.

1.3.2. Red Hat OpenShift AI with MicroShift
Copy link

With this release, you can access the most recent updates and improvements to supported Red Hat OpenShift AI (RHOAI) model-serving releases. The latest RHOAI release improves compatibility with the new Hugging Face Model Detector and Variable Length Language Model (VLLM) runtimes.

1.4. Documentation enhancements
Copy link

You can also benefit by using the following documentation enhancements.

  • With this release, instructions on uninstalling MicroShift are now included. For more information, see Uninstalling MicroShift.
  • With this release, instructions on encrypting etcd data are now included. For more information, see Encrypt etcd data.

1.5. Known issues
Copy link

Understand the known issues that impact your MicroShift development and deployments.

  • The maximum transmission unit (MTU) value in MicroShift OVN-K overlay networking must be 100 bytes smaller than the MTU value of the base network. MicroShift automatically configures the value using the MTU value of the default gateway of the host. If the auto-configuration does not work correctly, you must configure the the MTU value manually. For more information, see Network topology.

1.6. Additional release notes
Copy link

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

1.6.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 following Red Hat package download page and search for "gitops" if you just need the latest package: Red Hat packages.

1.6.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.6 for more information about RHEL.

See the Release notes for more information about Red Hat OpenShift AI Self-Managed.

1.7. Asynchronous updates
Copy link

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

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

Note

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

This section is updated over time to provide notes on enhancements and bug fixes for future asynchronous releases of MicroShift 4.20. Versioned asynchronous releases, for example with the form MicroShift 4.20.z, are detailed in the following subsections.

Issued: 21 October 2025

Red Hat build of MicroShift release 4.20.0 is now available. Bug fixes and enhancements are listed in the RHEA-2025:10667 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:9562 advisory.

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

Legal Notice
Copy link

Copyright © 2025 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, 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, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.
Back to top
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

© 2025 Red Hat