Skip to content

Containerize ASP.NET .NET Framework

Write Dockerfiles to run a legacy ASP.NET (.NET Framework) app in Windows containers

Stars
40,703
Licence
MIT
Files
1 file

What it does

This skill gives an AI agent a detailed checklist for packaging an older ASP.NET (.NET Framework, not .NET Core) web project into a Windows Docker container. The agent reads your project's .csproj file, picks a matching Microsoft Windows Server base image, and writes Dockerfile and .dockerignore files. It also edits web.config so app settings and connection strings are read from environment variables, and it tracks progress in a progress.md file. It is limited to changes needed for containerization and does not set up cloud infrastructure or change application code beyond that.

Great for

  • Developers moving a legacy ASP.NET Framework web app to Docker or a container platform
  • Teams who need a starting Dockerfile and config changes for a Windows Server based deployment
  • Engineers who want a repeatable checklist covering GAC assemblies, MSIs, COM components and IIS settings

Skip it if

  • Modern .NET (Core, 5+) projects, since the file says the process differs and this skill targets .NET Framework only
  • Linux containers, because the instructions assume Windows Server base images
  • Anyone expecting the agent to install NuGet packages automatically: the skill tells the agent to stop and ask you to install them yourself

Try asking

  • “Containerize my ASP.NET .NET Framework project MyWebApp/MyWebApp.csproj using Windows Server Core 2022”
  • “Create a Dockerfile and .dockerignore for my legacy ASP.NET app and move connection strings to environment variables”
  • “Add the EnvironmentConfigBuilder to my web.config so appSettings read from container environment variables”
Step-by-step guide: how to use Containerize ASP.NET .NET FrameworkInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 1 original files, the MIT licence and an attribution note.

    containerize-aspnet-framework.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip containerize-aspnet-framework.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip containerize-aspnet-framework.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Fill in the containerization settings (project path, Windows Server SKU and version, ports, user account) before running, since unspecified settings fall back to defaults
  • Install the required NuGet package yourself first, because the skill will pause and ask you to do it rather than installing it
  • Review the generated Dockerfile and web.config changes and test the container locally before deploying

What's inside

  • SKILL.md

Redistributed unmodified from github/awesome-copilot under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.