Umbraco

Setup guide for Umbraco 8.18.15 on Windows Server 2025.

Prerequisites

• Umbraco source ZIP
• UmbracoCms 8.18.15 NuGet package
• nuget.exe

Visual Studio 2019 with:

• ASP.NET and web development
• .NET desktop development
• .NET Framework 4.7.2 SDK
• .NET Framework 4.8 SDK
• IIS Express
• MSBuild

IIS with the following roles enabled:

• Common HTTP Features
• Application Development
  • .NET Extensibility 4.8
  • ASP.NET 4.8
  • ISAPI Extensions
  • ISAPI Filters

Build

1. Move nuget.exe to C:\tools\
2. Extract the source ZIP to C:\umbraco8
3. Restore NuGet packages:

cd C:\umbraco8\src
C:\tools\nuget.exe restore

4. Open C:\umbraco8\src\umbraco.sln in Visual Studio 2019
5. Right-click the solution → Restore NuGet Packages
6. Build the solution
7. Right-click Umbraco.Web.UI → Publish → File System → target C:\inetpub\umbraco8 → Publish

Fix Missing Static Files

The source build does not include installer static assets (CSS, JS, images). To fix:

1. Rename UmbracoCms.8.18.15.nupkg → UmbracoCms.8.18.15.zip and extract it
2. Copy only the static files from .\UmbracoFiles\* into C:\inetpub\umbraco8

Deploy

1. In IIS, right-click Sites → Add Website
   • Site name: umbraco8
   • Physical path: C:\inetpub\umbraco8
   • Port: 8888
2. Grant the AppPool full permissions:

icacls C:\inetpub\umbraco8 /grant "IIS AppPool\umbraco8:(OI)(CI)M" /T

3. Start the site and visit http://localhost:8888 — the Umbraco installation page should appear

Umbraco welcome page

Common Issues