Kentico Xperience 13 documentation and ASP.NET Core

Most documentation about running Xperience applications under ASP.NET Core can be found in a dedicated section: Developing Xperience applications using ASP.NET Core. The rest of the documentation still applies, but some code samples and scenarios might need slight modifications for Core projects.

Certain pages allow you to switch between Core and MVC 5 content using a selector located under the page heading.

All major differences between the MVC 5 and Core platforms are summarized in Migrating to ASP.NET Core.

×

Configuring IIS for the installation of Xperience

For Xperience to work correctly with your IIS, your system needs to have the following features enabled:

  • On Windows 8.1 and Server 2012/2012 R2: ASP.NET 4.5.NET Extensibility 4.5, ISAPI Extensions, ISAPI Filters and Static Content
  • On Windows 10 and Server 2016/2019: ASP.NET 4.7 or 4.8.NET Extensibility 4.7 or 4.8, ISAPI Extensions, ISAPI Filters and Static Content

Check that the features are enabled in your system.

If these features are not enabled, the Xperience Installer might not detect that IIS is installed on your computer, and could additionally install IIS Express.

Windows OS

  1. Open the Windows Control Panel.
  2. In the Control Panel, click Programs and Features and then click Turn Windows features on or off.

  3. In the Windows Features dialog, expand the Internet Information Services -> World Wide Web Services category.

  4. In the Application Development Features category, enable:

    • ASP.NET 4.5 (Windows 8.1)
    • ASP.NET 4.8 (Windows 10)

      This should automatically enable the .NET Extensibility (.NET Extensibility 4.5 / 4.8), ISAPI Extensions and ISAPI Filters features.

  5. In the Common HTTP Features category, enable the Static Content feature.
  6. Click OK.

On Windows 8.1:

Enabling IIS features on Windows 8

On Windows 10:

Enabling IIS features on Windows 10

Windows Server OS

If working with Windows Server editions, the process depends on your version:

Windows Server 2012 and 2012 R2

  1. Open the Windows Server Manager.
  2. Click Add roles and features in the Quick start section.
    • The Add Roles and Features Wizard dialog appears.
  3. Leave the settings and click Next until you get to the Server Roles step.
  4. Expand the Web Server (IIS) item.
  5. Select the following check boxes if they are not selected yet:
    • Common HTTP Features
      • Static Content
    • Application Development
      • .NET Extensibility 4.5
      • ASP.NET 4.5
      • ISAPI Extensions
      • ISAPI Filters
  6. Click Next until the Install button is enabled.
  7. Click Install and continue with the wizard.

Enabling IIS features on Windows Server 2012

Windows Server 2016 and 2019

  1. Open the Windows Server Manager.
  2. Click Add roles and features in the Quick start section.
    • The Add Roles and Features Wizard dialog appears.
  3. Leave the settings and click Next until you get to the Server Roles step.
  4. Expand the Web Server (IIS) item.
  5. Select the following check boxes if they are not selected yet:
    • Common HTTP Features
      • Static Content
    • Application Development
      • .NET Extensibility 4.7
      • ASP.NET 4.7
      • ISAPI Extensions
      • ISAPI Filters
  6. Click Next until the Install button is enabled.
  7. Click Install and continue with the wizard.

Enabling IIS features on Windows Server 2019


Was this page helpful?