Installing Ouvvi

The below tutorial will cover how to install Ouvvi using the deployment manager.

Once you have downloaded and installed Data Sync Ouvvi can be installed from the Ouvvi Deployment Manager found within the Data Sync tools menu. To open the Deployment Manager go to Tools>Ouvvi Deployment Manger.

Deployment Manager

When you first open the Deployment Manager you will be given the option to define a default Ouvvi Tenant. If you would like to use the default configuration Click Yes to create this.

Your Deployment Manager should now show an initial default Ouvvi Tenant if you choose to create the default Tenant. Otherwise you will need to define a new Ouvvi Tenant, please see our New Tenant page on how to do this.

Install IIS components

Before installing Ouvvi you will first need to ensure that the default IIS configuration is installed. To do this go to Tools > Install IIS Components.

This will run a PowerShell Script to install the required IIS Components.

Install IIS

Install SQL Server

Ouvvi requires a SQL Server to run and store all of the necessary project files. It can be run on all editions of Microsoft SQL Server, from SQL Express through to Enterprise Edition.

SQL Express is typically used to deploy Ouvvi unless you have an existing SQL Server.

To download SQL Server Express edition go to Tools > Download SQL Express which will direct you to the Microsoft Download page for SQL Express.

Download SQL Server

Download SQL Express

Choose Custom Install from the list and let the install package download.

Custom SQL Install

Once this has downloaded run the installer and choose 'New SQL Server'.

New SQL Server

This will open the SQL Server setup window. Run through this changing any of the settings as required.

For example you may wish to change which features are installed under the Feature Selection option. Ouvvi does not require Machine Learning Services or Full-Text Search Indexing.

Feature Selection

Click next to accept the install defaults and install SQL Server Express.

Edit Ouvvi Tenant Settings

To edit your Ouvvi tenant settings from the default configuration, double click on your Tenant to open the configuration window. Then change any of your configuration settings as required.

If you are editing the configuration of your Ouvvi Tenant after installation, please uninstall your Tenant before making any configuration changes. Re-installation after the changes have been made will not affect your projects, unless you have changed the SQL Server.

Install Ouvvi Tenant

You now need to install your tenant, right click onto your tenant and choose Install.


Then check the Log tab for confirmation of success, or to see any errors that may have occurred before proceeding.

Successful Install

To begin using Ouvvi browse to your site by right clicking and choosing Browse.


Check all of your settings are correct and then click Setup.

Ouvvi Database Setup

Install Ouvvi License Key

Ouvvi uses the same Server license key as Data Synchronisation Studio.

Ouvvi will not run any projects and steps without a valid license key installed.

To register your license key go to Settings > Register License and then enter your license key into the specified box and click 'Activate'.

Register License

If you do not have an internet connection and need to activate your key, please see our page on Manual License Key Activation.

Check Service User Permissions

If you have changed the Service account user, you will need to ensure that the User has been added to Ouvvi with Admin & Agent permissions.

If the service account is not listed under Settings > User Profiles then you will need to add the service account. If the service account is listed you need to ensure that agent and admin permissions are applied.

User Profiles

To apply Agent & Admin permissions either create a new user, or click on the user you wish to add permission to and check the checkboxes for Agent & Admin and then press Save.

Agent & Admin Permissions

Start Ouvvi Services

Now go back to the deployment manager and start your services by clicking the green play button in the menu.

Start Services

Now if we browse back to our Ouvvi site and go to Services > System Services we can see that all of the flags are green and the services are running.

Ouvvi Services Running