From d3698410694656f35c1769a435b3540b4394ed02 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Wed, 25 Mar 2026 13:08:32 +0000 Subject: [PATCH 1/4] Initial plan From f150d00d37b734138ff5adcb031350f0c286b7ee Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Wed, 25 Mar 2026 13:11:04 +0000 Subject: [PATCH 2/4] Add note that IIS doesn't support single-file deployments Co-authored-by: BillWagner <493969+BillWagner@users.noreply.github.com> Agent-Logs-Url: https://github.com/dotnet/docs/sessions/53374ddc-8038-48d0-8b50-fbb35f30c772 --- docs/core/deploying/single-file/overview.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/docs/core/deploying/single-file/overview.md b/docs/core/deploying/single-file/overview.md index a8f77464478c5..cf6bcf8b6590d 100644 --- a/docs/core/deploying/single-file/overview.md +++ b/docs/core/deploying/single-file/overview.md @@ -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 --- @@ -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 single-file deployments. If you deploy to IIS, publish your app using the standard folder deployment model instead. + 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. From 3846c39f226c234def4286ed8994e0a20419a2e0 Mon Sep 17 00:00:00 2001 From: Bill Wagner Date: Thu, 26 Mar 2026 08:23:06 -0400 Subject: [PATCH 3/4] Update docs/core/deploying/single-file/overview.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- docs/core/deploying/single-file/overview.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/core/deploying/single-file/overview.md b/docs/core/deploying/single-file/overview.md index cf6bcf8b6590d..bb2489859b0c2 100644 --- a/docs/core/deploying/single-file/overview.md +++ b/docs/core/deploying/single-file/overview.md @@ -148,7 +148,7 @@ For example, add the following property to the project file of an assembly to em ## Other considerations > [!IMPORTANT] -> IIS doesn't support single-file deployments. If you deploy to IIS, publish your app using the standard folder deployment model instead. +> 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 <\/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). From 2f9ed4a0554ae1748258b57a77e1738083e68fe3 Mon Sep 17 00:00:00 2001 From: Bill Wagner Date: Fri, 27 Mar 2026 22:29:39 -0400 Subject: [PATCH 4/4] Update docs/core/deploying/single-file/overview.md Co-authored-by: Andy (Steve) De George <67293991+adegeo@users.noreply.github.com> --- docs/core/deploying/single-file/overview.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/core/deploying/single-file/overview.md b/docs/core/deploying/single-file/overview.md index bb2489859b0c2..341b31c1994fc 100644 --- a/docs/core/deploying/single-file/overview.md +++ b/docs/core/deploying/single-file/overview.md @@ -148,7 +148,7 @@ 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 <\/aspnet/core/host-and-deploy/iis/>. +> 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).