Skip to content
/ Uintra Public

A flexible and lightweight Umbraco based framework, for making an Intranet, Extranet or social platform based on known conventions.


Notifications You must be signed in to change notification settings


Repository files navigation

Uintra - A social framework

A flexible and lightweight Umbraco based framework, for making an Intranet, Extranet or social platform based on known conventions.


Why Open Source?

We are trying to create a flexible and robust social framework. We think the best way to achieve this is through an online community, that can share and iterate through ideas. In order to create a solution that has valuable functionality validated by the users.

Getting started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.

Note: Currently Uintra will not function properly out of the box as a Web application, if you wish guidance to use Uintra as a web application, please contact us.

1. Prerequisites

Before installing Uintra you will have to make certain preparations.

  1. Install MS NET Framework .NET 4.7.2, can be found here.

  2. Install IIS with advanced settings (as seen in the screenshot below) ScreenShot

  3. MSSQLServer with Management Studio. Remember that the version of MSSQL server depends on your Windows version - 32-bit or 64-bit:

    • for latest version MSSQL server you need Windows 64-bit.
    • if you have Windows 32-bit we recommend you to install MSSQL server 2014. Here you can find all files to download and
      install (Express 32BIT WoW64\SQLEXPR32_x86 _ENU and MgmtStudio 32BIT\SQLManagementStudio_x86_ENU).
  4. Visual Studio 2017 with update 15.8.8 or later, can be found here. While installing Visual Studio 2017 you need to choose “ASP.NET and web development” on the Workloads tab: ScreenShot

    and fill in checkboxes “.NET Framework 4.7 SDK”, “.NET Framework 4.7 targeting pack” on the Individual components tab:

That is it for the prerequisites now we need to setup the server.

2. Setting up the database server

Using MSSQL Server Management Studio(in administrator mode) we will set up the database(DB) server:

  1. Open your DB server

    And add a new user for the login to the DB: ScreenShot

    Set up the server roles for the user: ScreenShot

  2. Create an empty DB

    Give it an appropriate name: ScreenShot

  3. Add security options for the server authentication, open properties ScreenShot

    Then go into "Security" and check the box as shown below: ScreenShot

  4. Restart your server

  5. Connect with the user you created in step 1 ScreenShot

Now your server is set up and ready for the Uintra installation!

3. Installing Uintra

Installing Uintra Open Visual Studio 2017 that you installed earlier

  1. Create a new project ScreenShot

    Choose “WEB” -> “ASP.NET Web Application(.NET Framework)”. Then choose “NET Framework 4.7.2” and add “Name”, “Location” (data storage on local machine), “Solution name”: ScreenShot

    In the next step choose the “Empty” template and press "OK": ScreenShot

  2. Right click on the new project in the "Solution explorer" block then click on "Manage NuGet packages" ScreenShot

  3. Press "Browse and search for "Uintra" ScreenShot NB! "Microsoft.CodeDom.Providers.DotNetCompilerPlatform" package should be version 2.0.1 (its compatible with UmbracoCMS 8.8.0)

    Install the latest package version: ScreenShot

  4. Press "OK", "Accept" and “yes to all” in the next popups accept proposals ScreenShot ScreenShot ScreenShot

  5. You should receive a message about 0 errors/warnings ScreenShot

Remove redundant items from Solution:

   - App_Start folder
   - Controllers folder
   - Models folder
       - UmbracoIdentityAccount folder
   - In Views folder:
       - Account.cshtml file
       - AccountLayout.cshtml file


Open Web.config file and make several corrections:

     1. The index name should be rewritten  <add key="Search.IndexName" value="[your index name]" /> for the correct work of the Elastic search     
     2. Replace row <add key="linkPreviewServiceUri" value="" /> with <add key="linkPreviewServiceUri" value="" /> for the correct work of the LinkPreview 


     3. Comment out the block for sitemap (unnecessary in some cases) 


  1. Right click on the new project in the “Solution explorer” block and press “Build” ScreenShot

  2. You should receive a message about a successful installation ScreenShot

With that Uintra is installed, the next and final step is setting up Uintra in IIS and continue the browser configuration.

4. Setting up Uintra

Using the Internet Information Services (IIS) Manager, we are going to add the new website.

  1. Adding the website

    Fill in the required fields and create the website: ScreenShot

    NB! The “Physical path” address should be the folder location for the Uintra project you made in Visual Studio 2017(data storage on local machine). In the "Applications Pools" set .NET Framework version 4.0.30319 for your new site.

  2. Add your new site IP-address and name to the “Hosts” file in the windows folder on your computer.

  3. Open your new site in the browser. You’ll be redirected to the “Install Umbraco” page. Fill in all the fields and choose "Customize" ScreenShot

    In the “Database type” dropdown choose Microsoft SQL Server: ScreenShot

    Fill in all the fields. Ensure that the "Server name" and "Database name" is identical with the labels in the MSSQL Server database. Use the credentials for the new user that was created earlier and press "Continue": ScreenShot

    Press "I don't want a custom Machine Key": ScreenShot

    Press the "No thanks, I do not want ...": ScreenShot

    Wait while Umbraco is installed and when it is done you should see the welcoming message: ScreenShot

Now Umbraco is installed.

  1. Configure Your Umbraco before start working with Uintra:

a. Specify a valid domain in "Culture and Hostnames" (Content section -> Home node), such as "mysite.local" and deploy through IIS, not through IISExpress


b. Start the uSync import (Settings section -> uSync node) and wait until everything is restored, it may take several minutes.


Success import will look like:


c. In some cases for correct Search working need to Rebuild index (Settings section -> Search tab):


  1. To administrate your new site, open it in a new tab ScreenShot

    The first login uses the following data: Login - admin, password - qwerty1234 (P.S. We strongly recommend to change this later)

That's all! Now you can open new site based on Uintra and enjoy!

If you are having trouble getting Uintra installed or experience other problems, please contact us at, the response time will be very fast within normal business hours, 09-16 CET/CEST.

Elastic Search

If Elastic Search is giving you trouble, please check out the issue #3 that will guide you to setup your elastic search with the proper version. Huge credit to user ChrisAngel447 for spotting this!

Running tests

We have created some simple examples of how to manually test Uintra here.

Contributing to Uintra?

A good way to contribute to Uintra is by providing issue reports. For information on how to submit an issue report refer to our guide to contributing for details on our code of conduct, and information regarding the process for submitting pull requests to us.


We have several managers and a full team working on Uintra, if you have any questions please send them to our contact person, Vadym at


This project is licensed under the MIT License - see the file for details.