Installing Ouvvi

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

Depending on the version of Data Sync you have installed you may be presented with a window asking if you would like to install or update your Ouvvi instances. Click on the Open Ouvvi Deployment Manager button to open the Deployment Manager.

Otherwise you can open the Deployment Manager through Data Sync by going to Tools -> Ouvvi Deployment Manager.

Open 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.

Default Install

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 Add Tenant page on how to do this.

Deployment Manager

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 begin the download of the SQL installer. Please note that this will open a command window whilst it downloads.

Install SQL Express

Once this has downloaded the SQL Server setup window will open. Run through this changing any of the settings if you need to, otherwise you can keep clicking next until the installation is complete.

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.

Please see Add Tenant for configuration details.

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 Data Synchronisation Studio 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 either click on the Activate hyperlink or 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 permission.

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. You can do this either by clicking the green play button in the menu or by right clicking on your instance and selecting Start Service from the list.

Start Services

Start Service from Menu

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