Illustration of a terminal window with a progress bar and a tick, showing a finished install

How to Install Optimizely?

First published in March 2023. Restored in October 2026, with notes on anything that has changed since.

Updated for CMS 13 (October 2026). Optimizely CMS 13 has been generally available since March 2026. It needs the .NET 10 SDK, SQL Server 2022 or Azure SQL, and Visual Studio 2026 or another editor that supports .NET 10. Install the templates and create an Alloy site with:

dotnet new install EPiServer.Templates
dotnet new epi-alloy-mvc --name <name_of_project>

Opti ID and Optimizely Graph are mandatory for full CMS 13 functionality, and the CMS admin interface now lives at /Optimizely/CMS (or /ui/cms once Opti ID is configured). Follow Optimizely’s Install CMS 13 guide (opens in a new tab) for the full steps. The instructions below are for CMS 12, and the -i option they use has since been replaced by dotnet new install.

Optimizely Installation Instructions

Below you will find detailed instructions on how to install Optimizely CMS12, including the Alloy Demo content on your local machine. Once installed, you’ll be ready to create your own bespoke content managed site, with the added benefit of ready to use templates to show you the way.

To get started you’ll need the following pre-requisites:

Microsoft Visual Studio
Microsoft SQL Server Express

How to Install Optimizely Templates

First you will want either create or navigate to the folder where you want to install the Alloy Demo site. The Optimizely templates are installed through PowerShell, so from this folder open a PowerShell window and enter the following command:

dotnet new -i EPiServer.Templates

Installing Optimizely Templates through PowerShell

Once the templates have been installed, you will see the following success message above. As you can see there are a number of Optimizely templates to choose from. We want to install the Alloy template, so enter the following command:

dotnet new epi-alloy-mvc --name <name_of_project>

You can use the –name parameter to specify the name of the Visual Studio Project, here I’ve called mine ‘OMVPAlloy’.

Installing Optimizely Alloy template through PowerShell

Running the Optimizely Template

Once the Alloy templates has been successfully installed, run the following command to restore the relevant NuGet packages and build the project:

dotnet build

Building the Optimizely Alloy project through PowerShell

Navigate to the installation folder, you will see that all the necessary project files have been created. Open the csproj file in Visual Studio and click run. A browser window will open to the Register screen where you can create and Admin user with a username, password and email address. Enter the required details and submit. You should now have access to Edit Mode of the CMS.

Additional Optimizely Templates

You now have everything you need to get started with creating your own Optimizely CMS12 site. As we saw there are additional templates you can install, such as an empty CMS or a Commerce template. Feel free to give these a try following the steps outlined above.

Additionally, through the Optimizely NuGet feed, you can add more features to your template project with packages provided by both Optimizely and third-parties. You can browse the Optimizely NuGet feed (opens in a new tab) to see what is available.

You’ve seen how to install Optimizely CMS12 in just a few short steps, though PowerShell and NuGet templates provided by Optimizely. If you have any questions or would like help developing Optimizely solutions please get in touch or read further articles about configuring Optimizely.

Frequently Asked Questions

What is Optimizely CMS?

Optimizely CMS is Optimizely's content management system for .NET, built on ASP.NET Core. CMS 13 has been generally available since March 2026; CMS 12 is the previous version. The Alloy demo site is a ready-made example project you can install to learn it.

How do I install Optimizely CMS 13?

Install the .NET 10 SDK and SQL Server 2022 or Azure SQL, then run the commands below. Follow Optimizely's Install CMS 13 guide for the full steps; Opti ID and Optimizely Graph are needed for full CMS 13 functionality.

  1. dotnet new install EPiServer.Templates
  2. dotnet new epi-alloy-mvc --name <name_of_project>

How do I install Optimizely CMS 12 and the Alloy demo site?

With Visual Studio and SQL Server Express installed, open PowerShell in the folder for your project and run these commands. Then open the project in Visual Studio, run it and register an admin account.

  1. dotnet new -i EPiServer.Templates (newer .NET versions use dotnet new install)
  2. dotnet new epi-alloy-mvc --name <name_of_project>
  3. dotnet build

What do I need before installing Optimizely CMS?

For CMS 13: the .NET 10 SDK, SQL Server 2022 or Azure SQL, and Visual Studio 2026 or another editor that supports .NET 10. For CMS 12: Visual Studio and SQL Server Express.

Where is the CMS admin interface in CMS 13?

At /Optimizely/CMS, or at /ui/cms once Opti ID is configured.