Skip to content

Document recommended pattern for installing .NET Framework 3.5 #1232

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 5 commits into from
Apr 1, 2025
Merged

Document recommended pattern for installing .NET Framework 3.5 #1232

Show file tree
Hide file tree
Changes from 2 commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
7f993e9
Add documentation
lbussell Mar 28, 2025
14e123d
Add notice to readmes
lbussell Mar 28, 2025
d5ea388
Remove locale from documentation URLs
lbussell Mar 31, 2025
25a3267
Revert "Add notice to readmes"
lbussell Mar 31, 2025
d4fd311
Add security updates info
lbussell Mar 31, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions .portal-docs/docker-hub/README.aspnet.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,10 @@

# About

> **NOTICE**: .NET Framework 3.5 images for Windows Server 2025 will no longer be published after May 13th.
> Guidance for installing .NET Framework 3.5 in your own container images can be found [here](https://github.com/microsoft/dotnet-framework-docker/blob/main/documentation/install-netfx3.md#windows-server-core-2022-and-later).
> See the [announcement](https://github.com/dotnet/announcements/issues/349) for more details.
ASP.NET is a high productivity framework for building Web Applications using Web Forms, MVC, Web API and SignalR.

This image contains:
Expand Down
4 changes: 4 additions & 0 deletions .portal-docs/docker-hub/README.runtime.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,10 @@

# About

> **NOTICE**: .NET Framework 3.5 images for Windows Server 2025 will no longer be published after May 13th.
> Guidance for installing .NET Framework 3.5 in your own container images can be found [here](https://github.com/microsoft/dotnet-framework-docker/blob/main/documentation/install-netfx3.md#windows-server-core-2022-and-later).
> See the [announcement](https://github.com/dotnet/announcements/issues/349) for more details.

This image contains the .NET Framework runtimes and libraries and is optimized for running .NET Framework apps in production.

Watch [discussions](https://github.com/microsoft/dotnet-framework-docker/discussions/categories/announcements) for Docker-related .NET announcements.
Expand Down
4 changes: 4 additions & 0 deletions .portal-docs/docker-hub/README.samples.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,10 @@

# About

> **NOTICE**: .NET Framework 3.5 images for Windows Server 2025 will no longer be published after May 13th.
> Guidance for installing .NET Framework 3.5 in your own container images can be found [here](https://github.com/microsoft/dotnet-framework-docker/blob/main/documentation/install-netfx3.md#windows-server-core-2022-and-later).
> See the [announcement](https://github.com/dotnet/announcements/issues/349) for more details.

These images contain sample .NET Framework, ASP.NET and WCF applications.

Watch [discussions](https://github.com/microsoft/dotnet-framework-docker/discussions/categories/announcements) for Docker-related .NET announcements.
Expand Down
4 changes: 4 additions & 0 deletions .portal-docs/docker-hub/README.sdk.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,10 @@

# About

> **NOTICE**: .NET Framework 3.5 images for Windows Server 2025 will no longer be published after May 13th.
> Guidance for installing .NET Framework 3.5 in your own container images can be found [here](https://github.com/microsoft/dotnet-framework-docker/blob/main/documentation/install-netfx3.md#windows-server-core-2022-and-later).
> See the [announcement](https://github.com/dotnet/announcements/issues/349) for more details.

This image contains the .NET Framework SDK which is comprised of the following parts:

1. .NET Framework Runtime
Expand Down
4 changes: 4 additions & 0 deletions .portal-docs/docker-hub/README.wcf.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,10 @@

# About

> **NOTICE**: .NET Framework 3.5 images for Windows Server 2025 will no longer be published after May 13th.
> Guidance for installing .NET Framework 3.5 in your own container images can be found [here](https://github.com/microsoft/dotnet-framework-docker/blob/main/documentation/install-netfx3.md#windows-server-core-2022-and-later).
> See the [announcement](https://github.com/dotnet/announcements/issues/349) for more details.

The Windows Communication Foundation (WCF) is a framework for building service-oriented applications. Using WCF, you can send data as asynchronous messages from one service endpoint to another. A service endpoint can be part of a continuously available service hosted by IIS, or it can be a service hosted in an application.

Watch [discussions](https://github.com/microsoft/dotnet-framework-docker/discussions/categories/announcements) for Docker-related .NET announcements.
Expand Down
4 changes: 4 additions & 0 deletions .portal-docs/mar/README.aspnet.portal.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,9 @@
## About

> **NOTICE**: .NET Framework 3.5 images for Windows Server 2025 will no longer be published after May 13th.
> Guidance for installing .NET Framework 3.5 in your own container images can be found [here](https://github.com/microsoft/dotnet-framework-docker/blob/main/documentation/install-netfx3.md#windows-server-core-2022-and-later).
> See the [announcement](https://github.com/dotnet/announcements/issues/349) for more details.

ASP.NET is a high productivity framework for building Web Applications using Web Forms, MVC, Web API and SignalR.

This image contains:
Expand Down
4 changes: 4 additions & 0 deletions .portal-docs/mar/README.runtime.portal.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,9 @@
## About

> **NOTICE**: .NET Framework 3.5 images for Windows Server 2025 will no longer be published after May 13th.
> Guidance for installing .NET Framework 3.5 in your own container images can be found [here](https://github.com/microsoft/dotnet-framework-docker/blob/main/documentation/install-netfx3.md#windows-server-core-2022-and-later).
> See the [announcement](https://github.com/dotnet/announcements/issues/349) for more details.

This image contains the .NET Framework runtimes and libraries and is optimized for running .NET Framework apps in production.

Watch [discussions](https://github.com/microsoft/dotnet-framework-docker/discussions/categories/announcements) for Docker-related .NET announcements.
Expand Down
4 changes: 4 additions & 0 deletions .portal-docs/mar/README.samples.portal.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,9 @@
## About

> **NOTICE**: .NET Framework 3.5 images for Windows Server 2025 will no longer be published after May 13th.
> Guidance for installing .NET Framework 3.5 in your own container images can be found [here](https://github.com/microsoft/dotnet-framework-docker/blob/main/documentation/install-netfx3.md#windows-server-core-2022-and-later).
> See the [announcement](https://github.com/dotnet/announcements/issues/349) for more details.

These images contain sample .NET Framework, ASP.NET and WCF applications.

Watch [discussions](https://github.com/microsoft/dotnet-framework-docker/discussions/categories/announcements) for Docker-related .NET announcements.
Expand Down
4 changes: 4 additions & 0 deletions .portal-docs/mar/README.sdk.portal.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,9 @@
## About

> **NOTICE**: .NET Framework 3.5 images for Windows Server 2025 will no longer be published after May 13th.
> Guidance for installing .NET Framework 3.5 in your own container images can be found [here](https://github.com/microsoft/dotnet-framework-docker/blob/main/documentation/install-netfx3.md#windows-server-core-2022-and-later).
> See the [announcement](https://github.com/dotnet/announcements/issues/349) for more details.

This image contains the .NET Framework SDK which is comprised of the following parts:

1. .NET Framework Runtime
Expand Down
4 changes: 4 additions & 0 deletions .portal-docs/mar/README.wcf.portal.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,9 @@
## About

> **NOTICE**: .NET Framework 3.5 images for Windows Server 2025 will no longer be published after May 13th.
> Guidance for installing .NET Framework 3.5 in your own container images can be found [here](https://github.com/microsoft/dotnet-framework-docker/blob/main/documentation/install-netfx3.md#windows-server-core-2022-and-later).
> See the [announcement](https://github.com/dotnet/announcements/issues/349) for more details.

The Windows Communication Foundation (WCF) is a framework for building service-oriented applications. Using WCF, you can send data as asynchronous messages from one service endpoint to another. A service endpoint can be part of a continuously available service hosted by IIS, or it can be a service hosted in an application.

Watch [discussions](https://github.com/microsoft/dotnet-framework-docker/discussions/categories/announcements) for Docker-related .NET announcements.
Expand Down
5 changes: 5 additions & 0 deletions README.aspnet.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,11 @@

## About

> [!CAUTION]
> .NET Framework 3.5 images for Windows Server 2025 will no longer be published after May 13th.
> Guidance for installing .NET Framework 3.5 in your own container images can be found [here](https://github.com/microsoft/dotnet-framework-docker/blob/main/documentation/install-netfx3.md#windows-server-core-2022-and-later).

Check failure on line 16 in README.aspnet.md

View workflow job for this annotation

GitHub Actions / check-markdown-links 

[Linkspector] reported by reviewdog 🐶
Cannot reach https://github.com/microsoft/dotnet-framework-docker/blob/main/documentation/install-netfx3.md#windows-server-core-2022-and-later Status: 404

Raw Output:
message:"Cannot reach https://github.com/microsoft/dotnet-framework-docker/blob/main/documentation/install-netfx3.md#windows-server-core-2022-and-later Status: 404" location:{path:"README.aspnet.md" range:{start:{line:16 column:88} end:{line:16 column:225}}} severity:ERROR source:{name:"linkspector" url:"https://github.com/UmbrellaDocs/linkspector"}
> See the [announcement](https://github.com/dotnet/announcements/issues/349) for more details.

ASP.NET is a high productivity framework for building Web Applications using Web Forms, MVC, Web API and SignalR.

This image contains:
Expand Down
5 changes: 5 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,11 @@

## About

> [!CAUTION]
> .NET Framework 3.5 images for Windows Server 2025 will no longer be published after May 13th.
> Guidance for installing .NET Framework 3.5 in your own container images can be found [here](https://github.com/microsoft/dotnet-framework-docker/blob/main/documentation/install-netfx3.md#windows-server-core-2022-and-later).

Check failure on line 15 in README.md

View workflow job for this annotation

GitHub Actions / check-markdown-links 

[Linkspector] reported by reviewdog 🐶
Cannot reach https://github.com/microsoft/dotnet-framework-docker/blob/main/documentation/install-netfx3.md#windows-server-core-2022-and-later Status: 404

Raw Output:
message:"Cannot reach https://github.com/microsoft/dotnet-framework-docker/blob/main/documentation/install-netfx3.md#windows-server-core-2022-and-later Status: 404" location:{path:"README.md" range:{start:{line:15 column:88} end:{line:15 column:225}}} severity:ERROR source:{name:"linkspector" url:"https://github.com/UmbrellaDocs/linkspector"}
> See the [announcement](https://github.com/dotnet/announcements/issues/349) for more details.

The [.NET Framework](https://www.microsoft.com/net/framework) is a general purpose development platform maintained by Microsoft. It is the most popular way to build client and server applications for Windows and Windows Server. It is included with Windows, Windows Server and Windows Server Core. It includes server technologies such as ASP.NET Web Forms, ASP.NET MVC and Windows Communication Foundation (WCF) applications, which you can run in Docker containers.

.NET has several capabilities that make development easier, including automatic memory management, (runtime) generic types, reflection, asynchrony, concurrency, and native interop. Millions of developers take advantage of these capabilities to efficiently build high-quality web and client applications.
Expand Down
5 changes: 5 additions & 0 deletions README.runtime.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,11 @@

## About

> [!CAUTION]
> .NET Framework 3.5 images for Windows Server 2025 will no longer be published after May 13th.
> Guidance for installing .NET Framework 3.5 in your own container images can be found [here](https://github.com/microsoft/dotnet-framework-docker/blob/main/documentation/install-netfx3.md#windows-server-core-2022-and-later).

Check failure on line 16 in README.runtime.md

View workflow job for this annotation

GitHub Actions / check-markdown-links 

[Linkspector] reported by reviewdog 🐶
Cannot reach https://github.com/microsoft/dotnet-framework-docker/blob/main/documentation/install-netfx3.md#windows-server-core-2022-and-later Status: 404

Raw Output:
message:"Cannot reach https://github.com/microsoft/dotnet-framework-docker/blob/main/documentation/install-netfx3.md#windows-server-core-2022-and-later Status: 404" location:{path:"README.runtime.md" range:{start:{line:16 column:88} end:{line:16 column:225}}} severity:ERROR source:{name:"linkspector" url:"https://github.com/UmbrellaDocs/linkspector"}
> See the [announcement](https://github.com/dotnet/announcements/issues/349) for more details.

This image contains the .NET Framework runtimes and libraries and is optimized for running .NET Framework apps in production.

Watch [discussions](https://github.com/microsoft/dotnet-framework-docker/discussions/categories/announcements) for Docker-related .NET announcements.
Expand Down
5 changes: 5 additions & 0 deletions README.samples.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,11 @@

## About

> [!CAUTION]
> .NET Framework 3.5 images for Windows Server 2025 will no longer be published after May 13th.
> Guidance for installing .NET Framework 3.5 in your own container images can be found [here](https://github.com/microsoft/dotnet-framework-docker/blob/main/documentation/install-netfx3.md#windows-server-core-2022-and-later).

Check failure on line 18 in README.samples.md

View workflow job for this annotation

GitHub Actions / check-markdown-links 

[Linkspector] reported by reviewdog 🐶
Cannot reach https://github.com/microsoft/dotnet-framework-docker/blob/main/documentation/install-netfx3.md#windows-server-core-2022-and-later Status: 404

Raw Output:
message:"Cannot reach https://github.com/microsoft/dotnet-framework-docker/blob/main/documentation/install-netfx3.md#windows-server-core-2022-and-later Status: 404" location:{path:"README.samples.md" range:{start:{line:18 column:88} end:{line:18 column:225}}} severity:ERROR source:{name:"linkspector" url:"https://github.com/UmbrellaDocs/linkspector"}
> See the [announcement](https://github.com/dotnet/announcements/issues/349) for more details.

These images contain sample .NET Framework, ASP.NET and WCF applications.

Watch [discussions](https://github.com/microsoft/dotnet-framework-docker/discussions/categories/announcements) for Docker-related .NET announcements.
Expand Down
5 changes: 5 additions & 0 deletions README.sdk.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,11 @@

## About

> [!CAUTION]
> .NET Framework 3.5 images for Windows Server 2025 will no longer be published after May 13th.
> Guidance for installing .NET Framework 3.5 in your own container images can be found [here](https://github.com/microsoft/dotnet-framework-docker/blob/main/documentation/install-netfx3.md#windows-server-core-2022-and-later).

Check failure on line 16 in README.sdk.md

View workflow job for this annotation

GitHub Actions / check-markdown-links 

[Linkspector] reported by reviewdog 🐶
Cannot reach https://github.com/microsoft/dotnet-framework-docker/blob/main/documentation/install-netfx3.md#windows-server-core-2022-and-later Status: 404

Raw Output:
message:"Cannot reach https://github.com/microsoft/dotnet-framework-docker/blob/main/documentation/install-netfx3.md#windows-server-core-2022-and-later Status: 404" location:{path:"README.sdk.md" range:{start:{line:16 column:88} end:{line:16 column:225}}} severity:ERROR source:{name:"linkspector" url:"https://github.com/UmbrellaDocs/linkspector"}
> See the [announcement](https://github.com/dotnet/announcements/issues/349) for more details.

This image contains the .NET Framework SDK which is comprised of the following parts:

1. .NET Framework Runtime
Expand Down
5 changes: 5 additions & 0 deletions README.wcf.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,11 @@

## About

> [!CAUTION]
> .NET Framework 3.5 images for Windows Server 2025 will no longer be published after May 13th.
> Guidance for installing .NET Framework 3.5 in your own container images can be found [here](https://github.com/microsoft/dotnet-framework-docker/blob/main/documentation/install-netfx3.md#windows-server-core-2022-and-later).

Check failure on line 14 in README.wcf.md

View workflow job for this annotation

GitHub Actions / check-markdown-links 

[Linkspector] reported by reviewdog 🐶
Cannot reach https://github.com/microsoft/dotnet-framework-docker/blob/main/documentation/install-netfx3.md#windows-server-core-2022-and-later Status: 404

Raw Output:
message:"Cannot reach https://github.com/microsoft/dotnet-framework-docker/blob/main/documentation/install-netfx3.md#windows-server-core-2022-and-later Status: 404" location:{path:"README.wcf.md" range:{start:{line:14 column:88} end:{line:14 column:225}}} severity:ERROR source:{name:"linkspector" url:"https://github.com/UmbrellaDocs/linkspector"}
> See the [announcement](https://github.com/dotnet/announcements/issues/349) for more details.

The Windows Communication Foundation (WCF) is a framework for building service-oriented applications. Using WCF, you can send data as asynchronous messages from one service endpoint to another. A service endpoint can be part of a continuously available service hosted by IIS, or it can be a service hosted in an application.

Watch [discussions](https://github.com/microsoft/dotnet-framework-docker/discussions/categories/announcements) for Docker-related .NET announcements.
Expand Down
29 changes: 29 additions & 0 deletions documentation/install-netfx3.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
# How to install .NET Framework 3.5 on Windows Server Core container images
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thoughts on commenting on the security update aspect of these patterns? By that I mean including a comment that this will always include the latest security updates and that rebuilds are necessary as new security updates are released.

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I added a section for this, let me know what you think.


## Windows Server Core 2022 and later

Windows Server Core 2022 and later container images can install [.NET Framework 3.5](https://learn.microsoft.com/en-us/windows-hardware/manufacture/desktop/features-on-demand-non-language-fod?view=windows-11#-net-framework) as a [Feature on Demand](https://learn.microsoft.com/en-us/windows-hardware/manufacture/desktop/features-on-demand-v2--capabilities?view=windows-11).

```Dockerfile
# escape=`
FROM mcr.microsoft.com/windows/servercore:ltsc2022-amd64

RUN dism /Online /Add-Capability /CapabilityName:NetFx3
```

## Windows Server Core 2019 and earlier

Windows Server Core 2019 and earlier can use Windows Update to install .NET Framework 3.5. See [Deploy .NET Framework 3.5 by using Deployment Image Servicing and Management (DISM)](https://learn.microsoft.com/windows-hardware/manufacture/desktop/deploy-net-framework-35-by-using-deployment-image-servicing-and-management--dism) for more info.

```Dockerfile
# escape=`
FROM mcr.microsoft.com/windows/servercore:ltsc2019-amd64

RUN `
# Enable Windows Update service
sc config wuauserv start= auto `
# Install .NET Framework 3.5
&& dism /Online /Enable-Feature /FeatureName:NetFx3 /All `
# Disable Windows Update service
&& sc config wuauserv start= disabled
```
8 changes: 8 additions & 0 deletions eng/readme-templates/About.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,8 +1,16 @@
{{

_ ARGS:
top-header: The string to use as the top-level header.
readme-host: Moniker of the site that will host the readmes

}}{{ARGS["top-header"]}} About

{{if ARGS["readme-host"] = "github":> [!CAUTION]
>^else:> **NOTICE**:}} .NET Framework 3.5 images for Windows Server 2025 will no longer be published after May 13th.
> Guidance for installing .NET Framework 3.5 in your own container images can be found [here](https://github.com/microsoft/dotnet-framework-docker/blob/main/documentation/install-netfx3.md#windows-server-core-2022-and-later).
> See the [announcement](https://github.com/dotnet/announcements/issues/349) for more details.

{{InsertTemplate(join(filter(["About", when(IS_PRODUCT_FAMILY, "product-family", SHORT_REPO), "md"], len), "."))}}

Watch [discussions](https://github.com/microsoft/dotnet-framework-docker/discussions/categories/announcements) for Docker-related .NET announcements.
Loading