Red Hat Summit Red Hat SummitSupportConsoleDevelopersStart a trialContact

Red Hat build of MicroShift release notes

Red Hat build of MicroShift 4.16

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 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.16 of Red Hat build of MicroShift includes new features and enhancements. MicroShift was introduced as Generally Available with MicroShift 4.14. 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.16 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.16 is supported on Red Hat Enterprise Linux (RHEL) or Red Hat Enterprise Linux for Edge (RHEL for Edge) 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. Red Hat Enterprise Linux (RHEL)
Copy link

  • MicroShift 4.16 runs on Red Hat Enterprise Linux (RHEL) 9.4.

1.2.2. Update two minor versions in a single step
Copy link

Updating two minor versions in a single step is now supported. Updates for both single-version minor releases and patch releases are still supported.

See the following list for details:

  • You can update from one long-life-cycle version of MicroShift directly to another, without applying the intermediate version. For example, you can update directly to 4.16 from 4.14. Updating 4.14 to 4.15 before updating to 4.16 is no longer required.
  • Now, you can focus on developing applications for your devices in remote locations and with limited bandwidth, rather than planning for updates.
  • MicroShift offers in-place updates on RHEL for Edge systems with automatic system rollback capabilities and automatic back up and restore functions.
  • Updates of the RPMs on a non-OSTree system such as {op-system} are also supported.
  • See Update options with Red Hat build of MicroShift and Red Hat Device Edge for details.

With this release, you can configure a custom server certificate that has been issued by an external certificate authority (CA). The default API server certificate is issued by an internal MicroShift node CA. You can now replace this certificate with one that is issued by a CA that clients trust. See Configuring custom certificate authorities.

You can now configure audit logging policies to manage the retention policies for log files, ensuring that edge devices with limited storage capacities are not hampered by accumulated logging data. To configure audit log policies, use settings such as a maximum file size limit and maximum retained files to set a limit on log storage size. You can also choose an audit policy profile to specify the data collected. See Configuring audit logs.

1.2.5. Support for cleaning up certificates
Copy link

With this release, you can clean up custom certificates. For more information, see Cleaning up and recreating the custom certificates.

1.2.6. Multiple networks capability now available
Copy link

With this release, using multiple networks is supported with the MicroShift Multus plugin. If you have advanced networking requirements, you can attach additional networks to a pod for high-performance network configurations. After installing the MicroShift Multus RPM package, you can use the Bridge, MACVLAN, or IPVLAN plugins to create additional networks. See Additional networks in MicroShift.

You can now configure ingress routes to create access to multiple services inside your MicroShift node. You can use a variety of combinations to customize the endpoint configuration for your use case. See About configuring the router.

You can now configure the route admission policy to allow routes to claim different paths of the same hostname across namespaces. See Configuring the route admission policy.

1.2.9. GitOps with Argo CD now available
Copy link

With this release, you can use the GitOps with Argo CD agent derived from GitOps 1.12 with MicroShift. Using GitOps means you can update a single Git repository and automate the deployment of new applications or updates to existing ones. You can also use your Git repository as an audit trail of changes so that you can create processes such as review and approval for merging pull requests that implement configuration changes. See Automating application management with the GitOps controller.

1.2.10. Getting a node ID
Copy link

With this release, you can get the ID of a MicroShift node. When opening a support case, you can provide the node ID to Red Hat Support to help in identifying issues with your node. See Getting your node ID.

During an SSL handshake between a client and a server, the cipher to use is negotiated between them. With this release, SSL Medium Strength Cipher Suites are now supported for the kube-controller-manager daemon, kube-scheduler control-plane process, and kubelet "node agent." This enhancement to the internal communication between Kubernetes components improves control plane communications security. (OCPBUGS-29037)

1.3. Documentation enhancements
Copy link

You can also benefit by using the following documentation enhancements.

1.3.1. Route configuration now documented
Copy link

With this release, specific details for creating and managing supported route configurations are documented, see Configuring routes.

1.4. Known issues
Copy link

Understand the known issue that impacts your MicroShift development and deployments.

Because of an issue with RHEL, when a pod tries to write files that are larger than configured memory limits to a persistent volume claim, the pod might crash with an out-of-memory error. The pod status shows OOMKilled when this occurs. Use the following workarounds to avoid this issue: Pods writing files larger than memory limit to PVCs tend to OOM frequently running on MicroShift(Red Hat Knowledgebase).

1.5. Asynchronous errata updates
Copy link

Security, bug fix, and enhancement updates for MicroShift 4.16 are released as asynchronous errata through the Red Hat Network.

All MicroShift 4.16 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.16. Versioned asynchronous releases, for example with the form MicroShift 4.16.z, are detailed in the following subsections.

Issued: 27 June 2024

Red Hat build of MicroShift release 4.16.0 is now available. The list of bug fixes that are included in the update is documented in the RHSA-2024:0043 advisory. The images that are included in the update are provided by the RHSA-2024:0041 advisory.

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

1.5.1.1. Bug fixes
Copy link
  • Previously, the MicroShift load balancer controller tried to update the IP addresses of every LoadBalancer service in the node. Some of these services, such as those with a defined loadBalancerClass, have their own update procedures for external IPs. This conflicted with the MicroShift controller. Now, services that have a loadBalancerClass are filtered and IP addresses owned by other load balancer services are ignored by MicroShift. (OCPBUGS-30833)
  • Previously, when microshift-etcd unexpectedly exited, MicroShift tried to restart so that microshift-etcd could restart, but there was a lingering unit fragment. Every attempt to restart microshift-etcd failed, making the system unusable. The --collect flag was added to the systemd-run invocation used to start microshift-etcd. The additional flag results in systemd cleaning up the unit fragment even if the unit failed. The system now recovers and restarts. (OCPBUGS-33588)

Issued: 3 July 2024

Red Hat build of MicroShift release 4.16.1 is now available. The list of bug fixes that are included in the update is documented in the RHBA-2024:4158 advisory. The images that are included in the update are provided by the RHSA-2024:4156 advisory.

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

Issued: 9 July 2024

Red Hat build of MicroShift release 4.16.2 is now available. The list of bug fixes that are included in the update is documented in the RHBA-2024:4318 advisory. The images that are included in the update are provided by the RHSA-2024:4316 advisory.

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

Issued: 16 July 2024

Red Hat build of MicroShift release 4.16.3 is now available. The list of bug fixes that are included in the update is documented in the RHBA-2024:4471 advisory. The images that are included in the update are provided by the RHSA-2024:4469 advisory.

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

1.5.4.1. Bug fixes
Copy link
  • An error in validation allowed empty entries in the listenAddress configuration parameter. The empty entries prevented MicroShift from starting and rendered a difficult-to-understand error message. Empty entries in the list are now filtered.

Issued: 24 July 2024

Red Hat build of MicroShift release 4.16.4 is now available. The list of bug fixes that are included in the update is documented in the RHBA-2024:4615 advisory. The images that are included in the update are provided by the RHSA-2024:4613 advisory.

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

Issued: 31 July 2024

Red Hat build of MicroShift release 4.16.5 is now available. The list of bug fixes that are included in the update is documented in the RHBA-2024:4857 advisory. The images that are included in the update are provided by the RHBA-2024:4855 advisory.

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

Issued: 6 August 2024

Red Hat build of MicroShift release 4.16.6 is now available. The list of bug fixes that are included in the update is documented in the RHBA-2024:4967 advisory. The images that are included in the update are provided by the RHSA-2024:4965 advisory.

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

Issued: 13 August 2024

Red Hat build of MicroShift release 4.16.7 is now available. The list of bug fixes that are included in the update is documented in the RHBA-2024:5109 advisory. The images that are included in the update are provided by the RHSA-2024:5107 advisory.

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

Issued: 20 August 2024

Red Hat build of MicroShift release 4.16.8 is now available. The list of bug fixes that are included in the update is attached to the RHBA-2024:5424 advisory. The images that are included in the update are provided by the RHSA-2024:5422 advisory.

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

Issued: 29 August 2024

Red Hat build of MicroShift release 4.16.9 is now available. The list of bug fixes that are included in the update is attached to the RHBA-2024:5759 advisory. The images that are included in the update are provided by the RHBA-2024:5757 advisory.

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

Issued: 11 September 2024

Red Hat build of MicroShift release 4.16.11 is now available. The list of bug fixes that are included in the update is attached to the RHBA-2024:6403 advisory. The images that are included in the update are provided by the RHBA-2024:6401 advisory.

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

Issued: 17 September 2024

Red Hat build of MicroShift release 4.16.12 is now available. The list of bug fixes that are included in the update is attached to the RHBA-2024:6634 advisory. The images that are included in the update are provided by the RHSA-2024:6632 advisory.

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

Issued: 19 September 2024

Red Hat build of MicroShift release 4.16.13 is now available. The list of bug fixes that are included in the update is attached to the RHBA-2024:6688 advisory. The images that are included in the update are provided by the RHSA-2024:6687 advisory.

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

Issued: 24 September 2024

Red Hat build of MicroShift release 4.16.14 is now available. The list of bug fixes that are included in the update is attached to the RHBA-2024:6826 advisory. The images that are included in the update are provided by the RHSA-2024:6824 advisory.

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

Issued: 2 October 2024

Red Hat build of MicroShift release 4.16.15 is now available. The list of bug fixes that are included in the update is attached to the RHBA-2024:7176 advisory. The images that are included in the update are provided by the RHSA-2024:7174 advisory.

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

Issued: 8 October 2024

Red Hat build of MicroShift release 4.16.16 is now available. The list of bug fixes that are included in the update is attached to the RHBA-2024:7601 advisory. The images that are included in the update are provided by the RHSA-2024:7599 advisory.

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

Issued: 16 October 2024

Red Hat build of MicroShift release 4.16.17 is now available. The list of bug fixes that are included in the update is attached to the RHBA-2024:7946 advisory. The images that are included in the update are provided by the RHSA-2024:7944 advisory.

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

Issued: 24 October 2024

Red Hat build of MicroShift release 4.16.18 is now available. The list of bug fixes that are included in the update is attached to the RHBA-2024:8262 advisory. The images that are included in the update are provided by the RHSA-2024:8260 advisory.

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

Issued: 30 October 2024

Red Hat build of MicroShift release 4.16.19 is now available. The list of bug fixes that are included in the update is attached to the RHBA-2024:8417 advisory. The images that are included in the update are provided by the RHSA-2024:8415 advisory.

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

Issued: 6 November 2024

Red Hat build of MicroShift release 4.16.20 is now available. The list of bug fixes that are included in the update is attached to the RHBA-2024:8685 advisory. The images that are included in the update are provided by the RHSA-2024:8683 advisory.

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

Issued: 13 November 2024

Red Hat build of MicroShift release 4.16.21 is now available. The list of bug fixes that are included in the update is attached to the RHBA-2024:8988 advisory. The images that are included in the update are provided by the RHBA-2024:8986 advisory.

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

Issued: 20 November 2024

Red Hat build of MicroShift release 4.16.23 is now available. The list of bug fixes that are included in the update is attached to the RHBA-2024:9617 advisory. The images that are included in the update are provided by the RHSA-2024:9615 advisory.

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

Issued: 26 November 2024

Red Hat build of MicroShift release 4.16.24 is now available. The list of bug fixes that are included in the update is attached to the RHSA-2024:10149 advisory. The images that are included in the update are provided by the RHSA-2024:10147 advisory.

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

Issued: 4 December 2024

Red Hat build of MicroShift release 4.16.25 is now available. The list of bug fixes that are included in the update is attached to the RHBA-2024:10530 advisory. The images that are included in the update are provided by the RHSA-2024:10528 advisory.

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

Issued: 12 December 2024

Red Hat build of MicroShift release 4.16.26 is now available. The list of bug fixes that are included in the update is attached to the RHBA-2024:10825 advisory. The images that are included in the update are provided by the RHSA-2024:10823 advisory.

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

Issued: 19 December 2024

Red Hat build of MicroShift release 4.16.27 is now available. The list of bug fixes that are included in the update is attached to the RHBA-2024:10975 advisory. The images that are included in the update are provided by the RHBA-2024:10973 advisory.

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

Issued: 2 January 2025

Red Hat build of MicroShift release 4.16.28 is now available. The list of bug fixes that are included in the update is attached to the RHBA-2024:11504 advisory. The images that are included in the update are provided by the RHBA-2024:11502 advisory.

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

Issued: 9 January 2025

Red Hat build of MicroShift release 4.16.29 is now available. The list of bug fixes that are included in the update is attached to the RHBA-2025:0020 advisory. The images that are included in the update are provided by the RHBA-2025:0018 advisory.

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

Issued: 15 January 2025

Red Hat build of MicroShift release 4.16.30 is now available. The list of bug fixes that are included in the update is attached to the RHBA-2025:0142 advisory. The images that are included in the update are provided by the RHSA-2025:0140 advisory.

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

Issued: 29 January 2025

Red Hat build of MicroShift release 4.16.32 is now available. With this release, MicroShift introduces a priority-based release cadence to provide the most important updates with the least disruption.

The list of bug fixes that are included in the update is attached to the RHBA-2025:0683 advisory. The images that are included in the update are provided by the RHBA-2025:0652 advisory.

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

Issued: 28 May 2025

Red Hat build of MicroShift release 4.16.41 is now available. The list of bug fixes that are included in the update is attached to the RHBA-2025:8127 advisory. The images that are included in the update are provided by the RHBA-2025:8116 advisory.

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

1.5.31.1. Bug fixes
Copy link
  • Previously, the greenboot health check was marking a RHEL for Edge healthy system as unhealthy due to a relatively low 300-second timeout. This timeout was not enough on systems with a slow network. With this release, the default greenboot wait timeout is now 600 seconds, meaning there is more time to download images. This results in an accurate system check.

Issued: 3 September 2025

Red Hat build of MicroShift release 4.16.47 is now available. The list of bug fixes that are included in the update is attached to the RHBA-2025:14926 advisory. The images that are included in the update are provided by the RHSA-2025:14859 advisory.

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

Issued: 19 March 2026

Red Hat build of MicroShift release 4.16.58 is now available. The list of bug fixes that are included in the update is attached to the RHSA-2026:4580 advisory. The images that are included in the update are provided by the RHSA-2026:4482 advisory.

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

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