How to Install Optimizely Foundation?
First published in July 2023. Restored in October 2026, with notes on anything that has changed since.
Update, October 2026. Foundation is a CMS 12 reference solution built on .NET 6, which Microsoft stopped supporting in November 2024. It also relies on Search & Navigation, which isn’t supported in CMS 13. For a new CMS 13 project, start from the CMS 13 templates instead (see How to install Optimizely).
What is Optimizely Foundation?
Optimizely Foundation is an open-source project offered by Episerver, now Optimizely, providing a structured and modular reference architecture for developers. It enables the integration of various Optimizely products into solutions. With projects for CMS, Commerce Connect (formerly Customized Commerce), Personalization, Search & Navigation, and the Community API, developers can select and include or exclude specific components as needed.
It has undergone rigorous testing, including penetration and load testing, and is certified to run on the DXP Service. Optimizely Foundation offers a starting point for development and showcases best practices through the Mosey demo site.
Optimizely Foundation Installation Instructions
In this article we’ll describe how to install the Optimizely Foundation open-source starter solution, as well as tips for fixing issues you may encounter along the way.
Prerequisites: installed the Optimizely CLI and templates, SQL, Node.js, .NET 6
Follow these instructions to install the Optimizely Foundation Starter Solution (opens in a new tab).
Get the next article by email
One email a month: the new article and the Optimizely changes worth knowing about.
