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 start the installation of Tosca Server, follow the steps below:

  1. Double-click the installation file Tricentis Tosca Server 15.0.0.exe. This opens the installer that guides you through the installation process.

  2. On the first page of the installer, agree to the terms and conditions and click Continue.

Navigate the installer

You can see all steps of the installation process on the left side of the installer window.

To navigate back and forth between the installation steps, click Next/Continue or Back.

Alternatively, click on the tabs on the side navigation panel to return to a previous step.

Navigate the installer


The installer checks if all required components are installed on your computer. If not, the system installs them during the setup.

  • The icon indicates that a component is already installed.

  • The icon indicates that a missing component will be installed automatically.

  • The icon is white if a particular component is selected in the list.

Click Next to continue.

Check setup type

In the subsequent screen, you see an overview of the features that are included in the installation.

Click Next to continue.

Select the installation directory

You can select the install location.

If you change the default installation folders, you must select directories to which all users have access.

Select install location

Click Next to continue.

Configure shared settings

You can configure the following service settings:

  • HTTP/HTTPS: select an HTTP or HTTPS binding for the features. The default setting is HTTPS.

    For HTTPS binding, enter the certificate thumbprint in the Certificate thumbprint field. It must meet the following requirements:

    • The SSL certificate is valid. Note that this also includes the certificate revocation list check, which may require an active internet connection.

    • The certificate's subject alternative name contains at least one valid DNS name.

      Note: you can't use wildcards. The certificate must contain the real DNS name.

    • The extended key usage extension includes the Server Authentication OID This ensures that the certificate implements Transport Layer Security (TLS) on the internet as described in RFC-5280.

    • The certificate has a private key.

    • The key is exportable. You must enable Mark as exportable in the Windows certificate import dialog when you import the certificate. If you haven't done so, you must renew the certificate.

    • The certificate is only stored in a single certificate store location of the local machine certificate store. That's the certificate store which is local to the machine and global to all its users.

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

    You can specify a different port. Use a value between 1 and 65535. The installer automatically checks the availability of the port when you enter a number.

Configure shared settings

Click Next to continue.

Review the installation

You can review the installation before you install.

Click Install to start the installation.

Finish installation

The Summary indicates whether all components have been installed successfully:

  • The icon indicates a successful installation.

  • The icon indicates an unsuccessful installation.

Review installation summary

Before you finish the installation you can perform the following actions:

  • Open Tosca Server in your browser.

  • Open the Tosca Server settings page in your browser.

If a component did not install properly, click Show Logs. You can also find the installation logs in the %TEMP% folder on your drive.

Click Finish to complete the installation.

What's next

Some Tosca Server services are disabled by default. If you want to use any of the services listed below, you need to enable them manually.

  • Interactive Testing Server

  • Exploratory Testing Server

  • Tricentis File Service

  • Tricentis Notification Service

  • Tosca REST API Service

If you don't need these services, you can jump straight to the Tricentis Service Configuration, where you configure the Tosca Server services that you want to use.