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.
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.
Before installing Uintra you will have to make certain preparations.
Install MS NET Framework .NET 4.7.2, can be found here.
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).
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:
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:
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
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="linkpreview.uintra.com" /> with <add key="linkPreviewServiceUri" value="https://linkpreview.uintra.com" /> for the correct work of the LinkPreview
3. Comment out the block for sitemap (unnecessary in some cases)
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.
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.
Add your new site IP-address and name to the “Hosts” file in the windows folder on your computer.
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":
Now Umbraco is installed.
- 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):
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 email@example.com, the response time will be very fast within normal business hours, 09-16 CET/CEST.
If Elastic Search is giving you trouble, please check out the issue https://github.com/Uintra/Uintra/issues/3 that will guide you to setup your elastic search with the proper version. Huge credit to user ChrisAngel447 for spotting this!
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 firstname.lastname@example.org
This project is licensed under the MIT License - see the file for details.