ubuntu/dotnet-runtime repository overview

ubuntu/dotnet-runtime is a rock for dotnet-runtime maintained by Canonical⁠.

.NET is a free, cross-platform, open source developer platform for building many different types of applications. With .NET, you can use multiple languages, editors, and libraries to build for web, mobile, desktop, games, IoT, and more. Read the .NET documentation⁠ to learn how to deploy your .NET application with container images.

⁠About Chiselled Ubuntu

This image does not include bash nor a package manager nor the .NET SDK. Read more about Chiselled Ubuntu for .NET, a new class of OCI images, on the Ubuntu blog⁠; reading how Canonical and Microsoft partner together to deliver and support .NET on Ubuntu.

If you're looking to publish a self-contained .NET app, please have a look at the ubuntu/dotnet-deps repository. If you're looking to publish an ASP.NET app, please then look at the ubuntu/dotnet-aspnet repository.

[Learn more about dotnet-runtime⁠]

⁠Tags and Architectures

NOTE: These tags follow a specific naming convention that respects the concept of channels⁠.

⁠Get started

This rock's entrypoint is Pebble, a container-optimized init process that enables the orchestration of a collection of local service processes as an organized set.

[Learn more about Pebble⁠]

⁠Inspect

To view the Pebble services⁠ and checks⁠ defined in this rock:

docker run --rm ubuntu/dotnet-runtime:9.0-25.04_stable plan

⁠Run

To run this rock, use any of the usual container runtimes, for example, docker:

docker run --name dotnet-runtime-container \
 -e TZ=UTC \
 ubuntu/dotnet-runtime:9.0-25.04_stable \
 exec dotnet

The container logs simply show the .NET help message. This is because the container expects a .NET application to be given.

⁠Use as a base

In some cases, you may want to augment this rock with additional runtime dependencies. In that case, you can use this rock as a base for your own custom build, as exemplified below:

Here is an example using a Dockerfile to build a .NET application image on top of a dotnet-runtime image:

⁠For rocks (9.0-25.04 and later)

# Create a HelloWorld.csproj file with the following content
$ cat <<EOF > HelloWorld.csproj
<Project Sdk="Microsoft.NET.Sdk">

 <PropertyGroup>
 <OutputType>Exe</OutputType>
 <TargetFramework>net10.0</TargetFramework>
 <ImplicitUsings>enable</ImplicitUsings>
 <Nullable>enable</Nullable>
 </PropertyGroup>

</Project>
EOF

# Create a Program.cs file with the following code
$ cat <<EOF > Program.cs
Console.WriteLine("Hello, World!");
EOF

Create a Dockerfile with the following content:

FROM ubuntu:26.04 AS builder

RUN apt-get update && apt-get install -y dotnet10 ca-certificates

# add your application code
WORKDIR /source
COPY . .

# publish your .NET app
RUN dotnet publish -c Release -o /app

FROM ubuntu/dotnet-runtime:10.0-26.04_edge

WORKDIR /app
COPY --from=builder /app ./

CMD ["exec", "dotnet", "/app/HelloWorld.dll"]

Build and run the image with the following commands:

$ docker build -t hello-world-app .
$ docker run --rm hello-world-app # This prints "Hello, World!"

⁠For Legacy images (6.0, 8.0, 9.0-24.10)

# Using .NET8 as an example
# Create a HelloWorld.csproj file with the following content
$ cat <<EOF > HelloWorld.csproj
<Project Sdk="Microsoft.NET.Sdk">

 <PropertyGroup>
 <OutputType>Exe</OutputType>
 <TargetFramework>net8.0</TargetFramework>
 <ImplicitUsings>enable</ImplicitUsings>
 <Nullable>enable</Nullable>
 </PropertyGroup>

</Project>
EOF

# Create a Program.cs file with the following code
$ cat <<EOF > Program.cs
Console.WriteLine("Hello, World!");
EOF

Create a Dockerfile with the following content:

FROM ubuntu:24.04 AS builder

# install the .NET 8 SDK from the Ubuntu archive
# (no need to clean the apt cache as this is an unpublished stage)
RUN apt-get update && apt-get install -y dotnet8 ca-certificates

# add your application code
WORKDIR /source
COPY . .

# publish your .NET app
RUN dotnet publish -c Release -o /app

FROM ubuntu/dotnet-runtime:8.0-24.04_beta

WORKDIR /app
COPY --from=builder /app ./

ENTRYPOINT ["dotnet", "/app/HelloWorld.dll"]

Build and run the image with the following commands:

$ docker build -t hello-world-app .
$ docker run --rm hello-world-app # This prints "Hello, World!"

⁠Get logs

To view the logs of the running container, run:

docker exec dotnet-runtime-container pebble logs

Or, for a specific service:

docker exec dotnet-runtime-container pebble logs <service>

⁠Monitor health checks

Rocks may have predefined health checks that you can list by running:

docker exec dotnet-runtime-container pebble checks

The overall health of your container can be inspected via:

docker exec dotnet-runtime-container pebble health

⁠Configuration

⁠Environment variables

[Report a bug⁠] [Contribute⁠]

Canonical is the provider of this container image. It is the user's responsibility to ensure that any use of this image complies with any relevant licenses for all software contained within, as well as with Canonical’s IP Policy⁠.

Tag summary

This week's pulls