Microsoft.NET.Build.Containers 8.0.123

Prefix Reserved
There is a newer version of this package available.
See the version list below for details.
dotnet add package Microsoft.NET.Build.Containers --version 8.0.123
                    
NuGet\Install-Package Microsoft.NET.Build.Containers -Version 8.0.123
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Microsoft.NET.Build.Containers" Version="8.0.123" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Microsoft.NET.Build.Containers" Version="8.0.123" />
                    
Directory.Packages.props
<PackageReference Include="Microsoft.NET.Build.Containers" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Microsoft.NET.Build.Containers --version 8.0.123
                    
#r "nuget: Microsoft.NET.Build.Containers, 8.0.123"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Microsoft.NET.Build.Containers@8.0.123
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Microsoft.NET.Build.Containers&version=8.0.123
                    
Install as a Cake Addin
#tool nuget:?package=Microsoft.NET.Build.Containers&version=8.0.123
                    
Install as a Cake Tool

.NET SDK Containers

This package lets you build container images from your projects with a single command.

Getting Started

To build a container from the SDK, add this package and run the publish command, specifying the DefaultContainer PublishProfile. You can learn more about Publish Profiles in the documentation.

>dotnet add package Microsoft.NET.Build.Containers
>dotnet publish --os linux --arch x64 -p:PublishProfile=DefaultContainer
...
Pushed container '<your app name>:<your app version>' to registry 'docker://'
...

Out of the box, this package will infer a number of properties about the generated container image, including which base image to use, which version of that image to use, and where to push the generated image. You have control over all of these properties, however. You can read more about these customizations here.

Note: This package only supports Web projects (those that use the Microsoft.NET.Sdk.Web SDK) in this version.

There are no supported framework assets in this package.

Learn more about Target Frameworks and .NET Standard.

  • net8.0

    • No dependencies.

NuGet packages (5)

Showing the top 5 NuGet packages that depend on Microsoft.NET.Build.Containers:

Package Downloads
UtilityBelt.Server

UBNet server.

IPP.PORTIC.SAFHE.Library

This software regards the project number 070200, SAFHE - Safe Health Elderly Monitoring, an EU funded project, and constitutes the technical contribution of the PORTIC-IPP together with the ESS-IPP (specifically both entities PORTIC - Porto Research, Technology and Innovation Center, and ESS - Escola Superior de Saúde, both sub-entities from the institution IPP - Instituto Politécnico do Porto) to the project.! The url of the project is: https://www.portic.ipp.pt/project.html

SotracomEntities

Package Description

MultiChannelReportLog-ex-1

Package Description

SotracomEntities_2024

Package Description

GitHub repositories (4)

Showing the top 4 popular GitHub repositories that depend on Microsoft.NET.Build.Containers:

Repository Stars
microsoft/dotnet-podcasts
.NET reference application shown at .NET Conf featuring ASP.NET Core, Blazor, .NET MAUI, Microservices, Orleans, Playwright, and more!
asynkron/protoactor-dotnet
Proto Actor - Ultra fast distributed actors for Go, C# and Java/Kotlin
rstropek/Samples
richlander/container-workshop
Documents fundamental .NET Container workflows
Version Downloads Last Updated
10.0.102 1,093 1/13/2026
10.0.101 2,576 12/9/2025
10.0.100 3,836 11/11/2025
10.0.100-rc.2.25502.107 340 10/14/2025
10.0.100-rc.1.25451.107 209 9/9/2025
10.0.100-preview.7.25380.108 187 8/12/2025
10.0.100-preview.6.25358.103 158 7/15/2025
10.0.100-preview.5.25277.114 190 6/6/2025
10.0.100-preview.4.25258.110 301 5/12/2025
10.0.100-preview.3.25201.16 280 4/10/2025
10.0.100-preview.2.25164.34 219 3/18/2025
10.0.100-preview.1.25120.13 229 2/25/2025
9.0.310 182 1/20/2026
9.0.309 190 1/13/2026
9.0.308 754 11/19/2025
9.0.307 490 11/11/2025
9.0.306 3,652 10/14/2025
9.0.305 3,701 9/9/2025
9.0.304 6,921 8/4/2025
9.0.303 1,867 7/17/2025
9.0.302 1,391 7/8/2025
9.0.301 6,219 6/10/2025
9.0.300 4,670 5/13/2025
9.0.205 685 6/10/2025
9.0.204 649 5/13/2025
9.0.203 9,654 4/8/2025
9.0.202 4,316 3/18/2025
9.0.201 5,134 3/11/2025
9.0.200 6,636 2/11/2025
9.0.200-preview.0.24575.35 637 12/10/2024
9.0.113 169 1/13/2026
9.0.112 475 11/11/2025
9.0.111 452 10/14/2025
9.0.110 531 9/9/2025
9.0.109 587 8/4/2025
9.0.108 519 7/8/2025
9.0.107 707 6/10/2025
9.0.106 672 5/13/2025
9.0.105 716 4/8/2025
9.0.104 735 3/11/2025
9.0.103 894 2/11/2025
9.0.102 15,314 1/14/2025
9.0.101 6,098 12/3/2024
9.0.100 12,562 11/12/2024
9.0.100-rc.2.24474.11 482 10/8/2024
9.0.100-rc.1.24452.12 264 9/10/2024
9.0.100-preview.7.24407.12 309 8/13/2024
9.0.100-preview.6.24328.19 267 7/9/2024
9.0.100-preview.5.24307.3 492 6/11/2024
9.0.100-preview.4.24267.43 287 5/21/2024
9.0.100-preview.3.24204.14 384 4/11/2024
9.0.100-preview.2.24157.36 402 3/12/2024
9.0.100-preview.1.24101.1 1,226 2/13/2024
8.0.417 307 1/13/2026
8.0.416 1,649 11/11/2025
8.0.415 972 10/14/2025
8.0.414 1,435 9/9/2025
8.0.413 898 8/5/2025
8.0.412 1,037 7/8/2025
8.0.411 1,074 6/10/2025
8.0.410 787 5/22/2025
8.0.409 756 5/13/2025
8.0.408 1,296 4/8/2025
8.0.407 5,211 3/11/2025
8.0.406 1,358 2/11/2025
8.0.405 3,738 1/14/2025
8.0.404 7,723 11/12/2024
8.0.403 37,991 10/8/2024
8.0.402 4,731 9/24/2024
8.0.401 38,642 8/15/2024
8.0.400 3,493 8/13/2024
8.0.319 410 11/11/2025
8.0.318 418 10/14/2025
8.0.317 477 9/9/2025
8.0.316 586 8/5/2025
8.0.315 457 7/8/2025
8.0.314 620 6/10/2025
8.0.313 511 5/22/2025
8.0.312 612 5/13/2025
8.0.311 597 4/8/2025
8.0.310 643 3/11/2025
8.0.309 730 2/11/2025
8.0.308 673 1/14/2025
8.0.307 780 11/12/2024
8.0.306 788 10/8/2024
8.0.304 776 8/13/2024
8.0.303 15,650 7/9/2024
8.0.302 18,711 6/11/2024
8.0.301 4,102 5/28/2024
8.0.300 15,627 5/14/2024
8.0.206 2,232 5/28/2024
8.0.205 825 5/14/2024
8.0.204 43,224 4/9/2024
8.0.202 19,990 3/12/2024
8.0.200 38,703 2/13/2024
8.0.123 148 1/13/2026
8.0.122 421 11/11/2025
8.0.121 405 10/14/2025
8.0.120 467 9/9/2025
8.0.119 546 8/5/2025
8.0.118 451 7/8/2025
8.0.117 618 6/10/2025
8.0.116 577 5/13/2025
8.0.115 1,108 4/8/2025
8.0.114 649 3/11/2025
8.0.113 673 2/11/2025
8.0.112 680 1/14/2025
8.0.111 780 11/12/2024
8.0.110 946 10/8/2024
8.0.108 819 8/13/2024
8.0.107 844 7/9/2024
8.0.106 849 5/28/2024
8.0.105 825 5/14/2024
8.0.104 901 4/9/2024
8.0.103 922 3/12/2024
8.0.102 1,023 2/13/2024
8.0.101 46,424 1/9/2024
8.0.100 117,575 11/14/2023
8.0.100-rc.2.23480.5 2,269 10/10/2023
8.0.100-rc.1.23462.41 1,268 9/14/2023
8.0.100-rc.1.23455.21 734 9/12/2023
8.0.100-preview.7.23376.5 1,461 8/8/2023
8.0.100-preview.6.23330.7 1,333 7/11/2023
8.0.100-preview.5.23303.1 1,315 6/13/2023
8.0.100-preview.4.23260.11 1,284 5/16/2023
7.0.410 14,267 5/28/2024
7.0.409 1,584 5/14/2024
7.0.408 2,476 4/9/2024
7.0.407 3,761 3/12/2024
7.0.406 6,170 2/13/2024
7.0.405 179,361 1/9/2024
7.0.404 24,074 11/14/2023
7.0.403 38,414 10/24/2023
7.0.402 19,534 10/10/2023
7.0.401 57,714 9/12/2023
7.0.400 150,299 8/8/2023
7.0.317 523 5/28/2024
7.0.316 504 5/14/2024
7.0.315 658 4/9/2024
7.0.314 636 3/12/2024
7.0.313 641 2/13/2024
7.0.312 584 1/9/2024
7.0.311 1,050 11/14/2023
7.0.310 711 10/24/2023
7.0.309 720 10/10/2023
7.0.308 758 9/12/2023
7.0.307 8,784 8/8/2023
7.0.306 48,260 7/11/2023 7.0.306 has at least one vulnerability with high severity.
7.0.305 35,182 6/22/2023 7.0.305 has at least one vulnerability with high severity.
7.0.304 16,594 6/13/2023 7.0.304 has at least one vulnerability with high severity.
7.0.302 76,131 5/16/2023 7.0.302 has at least one vulnerability with high severity.
0.4.0 208,010 3/22/2023 0.4.0 has at least one vulnerability with high severity.
0.3.2 188,015 1/20/2023 0.3.2 has at least one vulnerability with high severity.
0.2.7 165,728 10/27/2022 0.2.7 has at least one vulnerability with high severity.
0.1.8 15,851 8/25/2022 0.1.8 has at least one vulnerability with high severity.

# Microsoft.NET.Build.Containers 8.0.100

This version brings the following new features and enhancements:

* For .NET 8-targeting applications, the generated container user will not have root permissions by default. This is a breaking change from previous versions, but it is a more secure default. If you need to run your container as root, you can set the `ContainerUser` property to `root` in your project file. Note also that in .NET 8 several changes were made to the Microsoft .NET base images, like changing the default ASP.NET port to 8080, so applications newly-targeting .NET may have to adjust to these settings.
* Generated container images now default to using the `latest` tag instead of the value of the MSBuild `Version` property, to align with other container tooling. You can still override this behavior by setting the `ContainerTag` property in your project file.
* The `ContainerFamily` property was added to support choosing from different variants of image tags without needing to specify the entire base image. For example, to target Alpine Linux you can now set `ContainerFamily` to `alpine`.
* The generated images will now correctly set `User` and `ExposedPort` metadata based on well-known .NET Environment variables for these settings.
* We now support using base images that set `Entrypoint` instead of `Cmd`. The previous `ContainerEntrypoint` and `ContainerEntrypointArgs` properties are still supported, but will log a warning when used. You should now use `ContainerAppCommand` and `ContainerAppCommandArgs` instead to set the desired start application - these properties allow the tooling to select the proper app start command based on the base images' use of Entrypoint or Cmd. Thanks to @tmds for this functionality!
* We explicitly support using podman as a local destination for your containers. If `podman` is present on the system and `docker` is not, we will opt to use `podman` instead. If you'd like to make this behavior explicit you can set `LocalRegistry` to either `docker` or `podman`. Thanks to @tmds for this contribution!
* Permissions for files in the images not don't have the executable bit set unless it is necessary.
* Support for authenticating using Identity Token flows was added. This unblocks support for Azure Managed Identities, as well as all other registries where the result of `docker login <registry url>` is an Identity Token instead of an Access Token or Username/Password pair.