Install Tosca Server via setup dialog

You can install the Tosca Server in one of the following ways:

This chapter explains how to install the Tosca Server via setup dialog. For information on how to upgrade the Tosca Server, see the upgrade manual.


Before you start the installation, ensure that you meet all requirements listed in chapter Install Tosca Server.

Start the installation

To install Tosca Server, follow the steps below:

Double-click the installation file Tricentis Tosca Server13.4.exe. This opens the InstallShield Wizard.

As a first step, the system verifies whether you have all required components installed on your computer.

Example of components to be installed

Requirement Enable Internet Information Services (IIS) in the component check

The Tricentis Tosca Server features require IIS on the machine (see the system requirements).

If you have not already activated the following features, the InstallShield Wizard activates them during the installation:















* for IIS 8.

** for IIS 8.5 and IIS 10.

When you enable IIS for the first time, it creates the website Default Web Site on port 80. If you want to use this port for the Tricentis Tosca Server, you need to stop this website in the IIS Manager.

In the subsequent screen, Click Next to continue.

InstallShield Wizard

Accept the license agreement

In the subsequent screen, accept the terms of the license agreement.

Click Next to continue.

License Agreement

Tosca Diagnostics

In the Tosca Diagnostics dialog, specify whether you want to enable Tosca Diagnostics.

Tosca Diagnostics helps to improve the Tosca Server by anonymously sending usage data to Tricentis. For more information on the Tricentis privacy policy, see

Click Next to continue.

Enable Tosca Diagnostics

Select the installation directory

In the subsequent screen, specify the installation directory. By default, the InstallShield Wizard installs the Tricentis Tosca Server in C:\Program Files (x86)\TRICENTIS\Tosca Server.

Click Next to continue.

Destination Folder dialog

Select features for the installation

In the subsequent screen, choose which Tosca Server features you want to install.

Click Next to continue.

Select Tricentis Tosca Server features to install

For the File Service and Test Data Service, you need to install the Administration Console.

If you want to use the Tosca Rest API Service, you need to have Tosca Commander installed.

Configure the features

At this point, you need to perform an initial configuration of the selected Tricentis Tosca Server features. You can adapt or extend these configurations later on.

Click Configure to continue.

Configure the features

Depending on which features you selected, you can configure the following settings:

Shared settings

In the Tricentis Tosca Server shared Settings dialog, you can configure the following settings:

  • HTTP/HTTPS: Select an HTTP or HTTPS binding for the Tricentis Tosca Server features.

    If you want to protect your transferred user data, create an HTTPS binding with a valid signed certificate in the IIS Certificate Store after you have installed Tosca Server (see chapter "Use Tosca Server with an HTTPS binding").

  • Port: The default port is 80 for HTTP bindings , and 443 for HTTPS bindings.

    You can specify a different port. The port must be a value between 1 and 65535.

    Verify the availability of the port by clicking Check.

    Note that you can only use the default port 80 if you have disabled the website Default Web Site in the IIS Manager (see the note above).

    After three unsuccessful port checks, the Skip port check check box activates. Enable it to continue the installation despite an unsuccessful port check.

    Tricentis recommends that you don't; only continue the installation after a successful port check.

  • Data directory: Choose where to store data and log files for the features you install.

    The default path is C:\ProgramData\TRICENTIS\ToscaServer.

Shared settings

Tosca REST API Service settings

In the REST API Settings dialog, configure the Workspaces path, which is the path to the directory where all workspaces are stored.

The default path is %TRICENTIS_PROJECTS%\Tosca_Workspaces.

You can adapt or extend Tosca REST API Service configurations later on (see the Tosca REST API documentation).

Tosca REST API Service settings

By default, the Tosca Server uses the Identity LocalSystem for the Application Pool.

If you want to use the Identity ApplicationPoolIdentity, the Application Pool requires read and write permissions for the user IIS APPPOOL\<Application Pool Name> in the directory C:\Windows\System32\config\systemprofile.

Exploratory Testing Server settings

In the Exploratory Test Server Settings dialog, enter the activation key for the Exploratory Testing Server. This key is provided in your License Agreement.

You can also enter the key later on and continue the installation for now. You cannot send session invites to exploratory testers for as long as you haven't entered the key (see chapter "Configure Server").

Enter product key

Finish the installation

After you have configured your selected features, you can continue with the installation process.

Click Next to continue.

Successful configuration

The subsequent dialog provides you with a configuration overview.

Click Install to carry out the installation.

Configuration overview

In the final screen, finish the installation. Before you click Finish, you can specify the following actions:

  • View the installation protocol by selecting Show the Windows Installer log.

  • Open the Tricentis Tosca Server website by selecting Open Tosca Server in Browser.

  • Open the Tricentis Service Configuration by selecting Open Service Configurator.

  • If you chose an HTTPS binding during the installation, you can get information on the HTTPS configuration by selecting Open Tosca Server HTTPS configuration manual.

    The InstallShield Wizard automatically creates the desktop shortcut Tosca Server HTTPS Manual. You can also open the manual via the Windows Start Menu: Start->All Programs->Tricentis->Tosca Server->HTTPSManual.

Completed installation process

What's next

Depending on which Tosca Server features you selected during the installation, you may need to configure their services. For information on how to do so, Configure services via Tricentis Service Configuration.