Skip to content

Add IIS single-file deployment limitation note #52680

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
BillWagner merged 4 commits into from
Mar 28, 2026
+4 −1
Merged

Add IIS single-file deployment limitation note #52680

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
d369841
Initial plan
Copilot Mar 25, 2026
f150d00
Add note that IIS doesn't support single-file deployments
Copilot Mar 25, 2026
3846c39
Update docs/core/deploying/single-file/overview.md
BillWagner Mar 26, 2026
2f9ed4a
Update docs/core/deploying/single-file/overview.md
BillWagner Mar 28, 2026
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
5 changes: 4 additions & 1 deletion docs/core/deploying/single-file/overview.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: Create a single file for application deployment
description: Learn what single file application is and why you should consider using this application deployment model.
author: lakshanf
ms.date: 10/22/2025
ms.date: 03/25/2026
ms.custom: kr2b-contr-experiment
ai-usage: ai-assisted
---
Expand Down Expand Up @@ -147,6 +147,9 @@ For example, add the following property to the project file of an assembly to em

## Other considerations

> [!IMPORTANT]
> IIS doesn't support hosting ASP.NET Core apps that use single-file deployment with the in-process hosting model. If you host an ASP.NET Core app in IIS, publish your app using the standard folder deployment model, or use the out-of-process hosting model instead. For more information, see [Host ASP.NET Core on Windows with IIS](/aspnet/core/host-and-deploy/iis).

Single file applications have all related PDB files alongside the application, not bundled by default. If you want to include PDBs inside the assembly for projects you build, set the `DebugType` to `embedded`. See [Include PDB files inside the bundle](#include-pdb-files-inside-the-bundle).

Managed C++ components aren't well suited for single file deployment. We recommend that you write applications in C# or another non-managed C++ language to be single file compatible.
Expand Down
Loading