Installation steps that explains how to setup an empty Litium solution.

Read the system requirements for development environment before installing.

Follow the steps below:

  1. Open Visual Studio
  2. Create an empty web application that use .NET framework 4.6.1 or later
    Press OK
    Select Empty and Press OK. Note: Selecting any other template will result in a non startable site due to conflicts.
  3. Open Package Manager Console that is found in Tools > NuGet Package Manager menu.
  4. Update Microsoft packages for Roslyn compiller to the latest release (due to conflicting references, see issue)
    Update-Package Microsoft.CodeDom.Providers.DotNetCompilerPlatform
  5. Install Litium nuget-packages with the command in Package Manager Console
    Install-Package Litium.Web.Setup.Complete

Litium is now installed and you can start your solution with Start-command from Debug-menu.


For developers working in projects to login, Litium allows Windows accounts that are members of the server (or developer machine) administrator's group. The account can be a local server account or a domain account. When logging in with the windows account no account will be created in Litium for this login, but technically you will be logged in as "System" with full permissions.

The Windows account login only works for the Litium back office login page. To log in on the public site a regular Litium account is needed. This means that the back office login page handles both logging in with Windows credentials and Litium login. For Litium to know when a Windows account should be used, the username should contain a '\' (backslash) to separate the domain and the username in a Windows pre-2000 mode.


Database is placed in App_Data folder inside the Web Application you created. When you start the Web Application the database will be updated to the version of Microsoft Sql version that you localy is using. If using an older version on staging and/or production environment you find a default 2012r2 version of the database in the Tools\db folder inside Litium.Setup.Core package directory that you can use and attach on the environment.

Is this page helpful?
Thank you for your feedback!