Please note: for new projects we recommend starting out with sensenet 7, using our NuGet packages (or source code). For existing installations you can find custom upgrade instructions for your version on the releases page.
In this document we would like to guide you through the installation process of sensenet from a source package. We hope that you will encounter no complications during installation, or later on while working with sensenet. If you come across a bug by any chance, or have questions concerning our product, feel free to contact us at on gitter, slack or stackoverflow.
This document describes the steps of installing sensenet on machines with IIS 7.0 or higher version.
In case you are an Enterprise customer and want to use the
Task Managementfeature in sensenet (e.g. you want to have preview images for your documents), please install the
Task Managementcomponent first.
Download the sensenet source package. The latest version of this package is available on our CodePlex page.
The public CodePlex page above offers sensenet Community Edition. Customers who have access to the Enterprise Edition should use that source package. For differences between the two editions, please visit the following article: Differences between Community and Enterprise editions
If you did not install this package previously, please download and install it, as it is a prerequisite for building the sensenet solution. MSBuild Extension Pack
Extract the package to a folder of your choice, we will refer to this location as sourceroot later on.
Start IIS Manager (Control Panel\Administrative Tools\Internet Information Services (IIS) Manager).
Leave bindings of the created site as set by default - you will be able to access it using http://localhost. Ensure that no other (running) site is bound to localhost.
To use another hostname you will need to configure that address in the web.config with the urlList element. However we recommend you finish the installation first using the localhost binding.
Create a new website: Right click on Sites and select Add Web Site.
Choose a name for your site (Site name). Set your Physical path to: %sourceroot%\Source\SenseNet\WebSite
Ensure that the application pool of your site is configured properly. You can find the recommended settings for each version in the following table:
|SenseNet version||.NET Framework version of the application pool|
|6.0.1 or before||v2.0|
|6.0.2 or later||v4.0|
To edit application pool settings, you should follow the steps below:
By clicking on Application pool in the upper left corner you will get the list of available application pools. If the settings of your site’s application pool doesn’t match the recommended settints (See table 1) you have to change it.
Double-click on the application pool of your site, then select the appropriate version of .NET Framework from the .NET Framework version dropdown.
The easiest way to set up database connection is creating an Alias in your SQL Server Configuration Manager.
Use the values from the following table (you have to replace DB_SERVER_NAME to the name of your sql server instance)
|Property name||Property value|
- The **Alias Name** must be set exactly as above, please be aware of uppercase and lowercase - characters and remove any leading or trailing space characters that may got there because - of a copy/paste operation.
- Please create an alias for **every configuration**. In the image above you see two Alias nodes in - the tree: please create the alias for both!
Please go through the Client Protocols sections for all configurations above, and enable all protocol types (Named pipes, TCP/IP).
Open %sourceroot%\Source\SenseNet\SenseNet.sln in Visual Studio
Rebuild the entire solution
To run this script you need to have administrative rights for the SQL Server instance.
Run the install script: %sourceroot%\Deployment\InstallSenseNet.bat
-If the installation fails because of dll load errors (e.g. you see "Could not load library" on the - console) than make sure that all dll files in the Tools, bin, and References folders are unblocked. - You can unblock files in a single folder using the Unblock-File command in Windows PowerShell: dir "C:\SenseNet\References" | Unblock-File dir "C:\SenseNet\Source\SenseNet\Website\bin" | Unblock-File dir "C:\SenseNet\Source\SenseNet\Website\Tools" | Unblock-File
The identity of the application pool running the site must be (at least) the dbowner of SenseNetContentRepository database. (Hint: if your app pool is running in the name of
ApplicationPoolIdentity you may create a new login for IIS APPPOOL<application pool name> in Microsoft SQL Server Management Studio (don’t search for this user, just type it in) and grant db_owner permissions).
You can browse your application on http://localhost This link works only if you have a live demo install on your localhost!
Don’t forget! Some feature needs authentication and/or admin rights!).
Is something missing? See something that needs fixing? Propose a change here.