The following procedure describes how to install Kentico Xperience. The installation creates two separate projects – an MVC 5 or ASP.NET Core project for the live site, and an Xperience project that provides the content editing and administration interface.
- Click Next on the welcome screen of the installer.
- Select your country. The installer automatically tries to pre-select the appropriate country based on your system's locale.
- Accept the license terms.
- Click Next.
- Click Custom installation.
- Check if the installation location for the program files suits you (these are only the setup files, not the web project).
- Click the file system path if you wish to specify a custom location for the program files.
- When should I install only program files?
- Click Next.
Select a development model (ASP.NET Core or ASP.NET MVC 5) and click Next.
Specify the target location for the new web projects.
Installing new MVC sites into existing Xperience instances
If you wish to add a new MVC site into an existing Xperience administration project, set the target location to the given project's installation folder.
In this scenario, the installer adds the MVC project into the specified folder and uses the administration project's existing database. A new Xperience administration project is not created.
Installation into existing instances is NOT supported for ASP.NET Core projects.
- Configure the installation type options:
Register to IIS – if enabled, the installer registers the new web projects as applications in the local Internet Information Services server.
- When to register installed projects into IIS?
If you do not have IIS installed, the utility automatically installs the simplified version, IIS Express.
- If you disable registration to IIS in the installer, you need to create and configure the IIS applications manually after the installation (for both live site and Xperience administration projects). Also, you need to set the Presentation URL of your site in the Xperience Sites application to the URL where your live site is running (see Setting domain names for sites).
The installer does not support automatic registration into IIS for ASP.NET Core live site projects, only for the Xperience administration application. To learn more about registering Core projects under IIS together with the administration application, see Host ASP.NET Core on Windows with IIS.
- New site – installs a blank project suitable for the development of a new site. Enter a Name, which affects all things related to the new project, such as the project folder on the file system, the project and assembly name in Visual Studio, the virtual directory and application name in IIS, and the name of the corresponding site in Xperience.
Dancing Goat sample site – installs a sample project and site. Suitable for evaluation purposes or as inspiration for your own development.
License limitations for the sample site
- Click Next.
- Select the I have access to SQL server option.
If you are installing a new MVC site into an existing Xperience instance, the installer automatically uses the given instance's database. In this scenario, all information on the Database tab is read-only, and you can directly start the installation by clicking Install (skip the remaining steps on this page).
Specify the name of your SQL server and choose an authentication option.
If you choose the Integrated Windows authentication option, make sure that your Windows account exists as a user in the SQL server database, and has full permissions and the correct schema configured (the recommended database schema is dbo).
- Click Establish connection.
- Type the name of a new database for your web project.
- Click Next.
- Choose which additional components you wish to install for the Xperience administration project (not available when installing an MVC site into an existing Xperience instance).
- Click Next.
- Decide whether to enable the Kentico improvement program for the installed instance (via the Send anonymous usage records to Kentico checkbox).
- Click Install.
After the installation is successfully finished, the administration interface opens in the default browser. If you have installed the Dancing Goat sample site, the live site also opens in another tab. For new sites, the installation creates a blank project and an empty site, so you need to develop the code and add content before the live site becomes available.
For MVC 5 projects
The default URL of the live site is based on the following pattern: http://localhost/<target location folder>_<site name>
For example: http://localhost/Xperience_AcmeSite or http://localhost/Xperience_DancingGoatMvc (for the Dancing Goat MVC sample site)
The default URL of the administration interface is: http://localhost/<target location folder>_Admin
For ASP.NET Core projects
The default URL of the administration interface is:location folder>_Admin
The connected live site project is not by default registered to IIS or any other hosting server.
If installing the Dancing Goat Core sample site, the installation process starts a Kestrel instance (using dotnet run) after the installation finishes. In this case, the application starts running on a randomly selected empty port.
Administration interface credentials
To sign in to the administration interface after the installation, use the administrator username with a blank password. We strongly recommend setting a new password for the administrator account after the installation.