Release Notes for .NET 8.0 containers

.NET 8.0

Red Hat Customer Content Services


The Release Notes for .NET 8.0 containers provide high-level coverage of the features and functionality that comprise the .NET 8.0 platform and document known problems in this release.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. We are beginning with these four terms: master, slave, blacklist, and whitelist. Because of the enormity of this endeavor, these changes will be implemented gradually over several upcoming releases. For more details, see our CTO Chris Wright’s message.

Providing feedback on Red Hat documentation

We appreciate your feedback on our documentation. Let us know how we can improve it.

Submitting feedback through Jira (account required)

  1. Log in to the Jira website.
  2. Click Create in the top navigation bar
  3. Enter a descriptive title in the Summary field.
  4. Enter your suggestion for improvement in the Description field. Include links to the relevant parts of the documentation.
  5. Click Create at the bottom of the dialogue.

Chapter 1. New features

The Release Notes for .NET 8.0 containers is an extension of the Release Notes for .NET 8.0 RPM packages. See Release Notes for .NET 8.0 RPM packages for information about known issues, the operating system architecture, privacy, and support.

Chapter 2. Known issues

  1. NodeJS is no longer included in the .NET 8.0 SDK image.

    For information on how to port an application that depends on Node.js from an earlier .NET version to the .NET 8.0 image, see the Porting web applications with NodeJS front-ends to build with .NET 8.0 UBI images Knowledgebase solution.

  2. The random user used by OpenShift Container Platform is no longer added to the /etc/passwd file on OpenShift Container Platform 3.11. As a result, the .NET Environment.UserName property returns an empty string.
  3. The DOTNET_CORE_VERSION and DOTNET_FRAMEWORK environment variables were removed from the image. Instead, The image now includes exact versions of the .NET framework, the ASP.NET Core frameworks, and the SDK version in the DOTNET_VERSION, ASPNET_VERSION, and DOTNET_SDK_VERSION environment variables, respectively..
  4. The DOTNET_SSL_DIRS environment variable used to load certificates from additional directories is no longer handled by the image entrypoint. The default s2i (source-to-image) assemble and run scripts still process the environment variable. To trust certificates in all cases, use SSL_CERT_DIR instead.
  5. In .NET 8.0, you can no longer specify the command and its arguments to run in a container as a single string. You need to pass the arguments as separate strings. The new syntax also works for the earlier .NET versions.

    For example, instead of podman run “echo hello”, use podman run echo hello.

  6. The dnf command is not available.

    To reduce image size, .NET 8.0 container images use the ubi-minimal base image instead of the ubi base image. The ubi-minimal image uses the microdnf command as its package manager instead of the dnf command.

    If your Dockerfiles/Containerfiles use the dnf command, you must change them to use the microdnf command instead.

    For more information about the microdnf command, please see the microdnf man page.

See Known Issues in the .NET 8.0 Release Notes for .NET 8.0 RPM packages for a list of known issues and workarounds for RPMs.

Legal Notice

Copyright © 2023 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 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.