dotnet / dotnet/AspNetCore.Docs

Guidance on using ASP.NET Core 2.1 on .NET Framework

Open
#22,565 11 comments 2 reactions 0 assignees View on GitHub
doc-enhancement
Dominant language
C#
Stars
13.1k
Forks
24.6k
Avg merge
1d 3h
Merged PRs (30d)
97

Description

I'm happy to PR/contribute this content, but I need guidance on where it'll live. Should it live in the latest docset? Or should it only exist for 2.1?

# Issue description

I'd like to add guidance on using ASP.NET Core 2.1 on .NET Framework when hosting in IIS. Especially given that 2.1 is going out of support soon. We will no longer be producing 2.1 SDKs or 2.1 hosting bundles.

### Dev Requirements:
- A supported version of the .NET SDK to build ASP.NET Core 2.1 applications for .NET Framework

### Production Requirements:
- A supported version of the .NET Hosting bundle.

> NOTE: The .NET Hosting bundle contains other .NET Runtime components. If you do not intend to use the runtime components, the guidance is to install ANCM without the runtime components.

> `./dotnet-hosting-x.y.z-win.exe /install /q /norestart OPT_NO_RUNTIME=1 OPT_NO_SHAREDFX=1`

### Build-time changes:

Add the following properties to you project file:

```xml

AspNetCoreModuleV2
OutOfProcess

```

Alternatively, if you do not want to make a build change, you could just change the published `web.config` to start using ANCMv2 and specify `outofprocess` as the hosting model.

```xml






```

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.