Red Hat Summit Red Hat SummitSupportConsoleDevelopersStart a trialContact

Chapter 1. Using .NET Core 3.0 on Red Hat Enterprise Linux 8

This Getting Started Guide for RHEL 8 describes how to install .NET Core 3.0 on Red Hat Enterprise Linux (RHEL). See Red Hat Enterprise Linux documentation for more information about RHEL 8.

1.1. Install .NET Core
Copy link

.NET Core 3.0 is included in the AppStream repositories for RHEL 8. The AppStream repositories are enabled by default on RHEL 8 systems.

  1. Install .NET Core 3.0 and all of its dependencies: 

    $ sudo yum install dotnet-sdk-3.0 -y
    Copy to Clipboard Toggle word wrap

  2. Run the following command to verify the installation: 

    $ dotnet --info
.NET Core SDK (reflecting any global.json):
 Version:   3.0.100
 Commit:    xxxxxxxxxx

Runtime Environment:
 OS Name:     rhel
 OS Version:  8
 OS Platform: Linux
 RID:         rhel.8-x64
 Base Path:   /usr/lib64/dotnet/sdk/3.0.100/

Host (useful for support):
  Version: 3.0.0
  Commit:  xxxxxxxxxx

.NET Core SDKs installed:
  3.0.100 [/usr/lib64/dotnet/sdk]

.... omitted
    Copy to Clipboard Toggle word wrap

1.2. Create an Application
Copy link

  1. Create a new Console application in a directory called hello-world: 

    $ dotnet new console -o hello-world
  The template "Console Application" was created successfully.

  Processing post-creation actions...
  Running 'dotnet restore' on hello-world/hello-world.csproj...
  Restore completed in 87.21 ms for /home/<USER>/hello-world/hello-world.csproj.

  Restore succeeded.
    Copy to Clipboard Toggle word wrap

  2. Run the project: 

    $ cd hello-world
$ dotnet run
Hello World!
    Copy to Clipboard Toggle word wrap

1.3. Publish Applications
Copy link

The .NET Core 3.0 applications can be published to use a shared system-wide version of .NET Core or to include .NET Core. These two deployment types are called framework-dependent deployment (FDD) and self-contained deployment (SCD), respectively.

For RHEL, we recommend publishing by FDD. This method ensures the application is using an up-to-date version of .NET Core, built by Red Hat, that includes a specific set of native dependencies. On the other hand, SCD uses a runtime built by Microsoft.

  1. Use the following command to publish a framework-dependent application. 

    $ dotnet publish -f netcoreapp3.0 -c Release
    Copy to Clipboard Toggle word wrap

  2. Optional: If the application is only for RHEL, trim out the dependencies needed for other platforms with these commands. 

    $ dotnet restore -r rhel.8-x64
$ dotnet publish -f netcoreapp3.0 -c Release -r rhel.8-x64 --self-contained false
    Copy to Clipboard Toggle word wrap

1.4. Run Applications on Linux Containers
Copy link

This section shows how to use the ubi8/dotnet-30-runtime image to run a precompiled application inside a Linux container.

  1. Create a new mvc project in a directory named mvc_runtime_example. 

    $ dotnet new mvc -o mvc_runtime_example
$ cd mvc_runtime_example
    Copy to Clipboard Toggle word wrap

  2. Publish the project. 

    $ dotnet publish -f netcoreapp3.0 -c Release
    Copy to Clipboard Toggle word wrap

  3. Create the Dockerfile. 

    $ cat > Dockerfile <<EOF
FROM registry.access.redhat.com/ubi8/dotnet-30-runtime

ADD bin/Release/netcoreapp3.0/publish/ .

CMD ["dotnet", "mvc_runtime_example.dll"]
EOF
    Copy to Clipboard Toggle word wrap

  4. Build your image. 

    $ podman build -t dotnet-30-runtime-example .
    Copy to Clipboard Toggle word wrap

  5. Run your image. 

    $ podman run -d -p8080:8080 dotnet-30-runtime-example
    Copy to Clipboard Toggle word wrap
  6. View the result in a browser: http://127.0.0.1:8080.

Report a bug

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