Install Tosca Server

This chapter gives an overview of the Tosca Server features and installation.

To get an overview of all tasks that administrators need to perform to set up Tricentis Tosca for users, see chapter "Set up Tricentis Tosca".

Tosca Server with Gateway

For a smoother use of the features and services, Tosca Server allows clients to access every self-hosted service through a single endpoint: the Gateway. Gateway utilizes Ocelot Gateway Framework as an API gateway and a reverse proxy. As an API gateway, it controls API requests, and as a reverse proxy, it validates and forwards client requests to other components of the Tosca Server. The Gateway is a firewall and a communication proxy between clients and the Tosca Server. Communication is safer, because clients don't communicate directly with the dedicated services within the Tosca Server

The Gateway also functions as a service of its own. It encapsulates the Tosca Server Landing Page and Tricentis Service Discovery which is now hosted by the third-party service Consul.

Tosca Server features

The Tosca Server contains the following self-hosted components:


To install the Tosca Server, you must fulfill the following requirements:

  • You have the necessary software and hardware listed in the Tosca Server system requirements.

  • You have downloaded the Tosca Server installation package (see chapter "Download the installation packages"). The package contains the installation file Tosca Server 15.0.0.exe.

  • The Tosca Server that you want to install has the same version number as your installed version of Tricentis Tosca.

  • You have local administrator rights, which you need to install the Tosca Server.

  • If you want to use the Tosca Administration Console or the Tosca REST API Service: you have installed Tricentis Tosca on the machine where you want to install the Tosca Server. If you install Tricentis Tosca after you have installed the Tosca Server, reboot your machine first.

System restarts

The installation may require one or more restarts of the operating system.

If you want full control over your restarts and avoid automatic restarts, you need to install the following components manually before you install the Tosca Server:

Installation process

To install the Tosca Server, follow the steps below:

  1. Perform the installation in one of the following ways:

  2. The following Tosca Server services are disabled by default:

    If you want to use one of these services, you need to enable it manually first. To do so, open the Windows Services app and set the Startup type to Automatic.

    This step is especially important for Tricentis File Service and Tricentis Notification Service. If you don't enable them, you can't make the necessary configurations in the Tricentis Service Configuration.

  3. Configure your Tosca Server services in the Tricentis Service Configuration. Saving your configurations starts/restarts the service you configured.

  4. If you have configured Tosca Server to use HTTPS, make the necessary modifications as described in chapter "Use Tosca Server with an https binding".

  5. If you want to use one of the services listed below, you need to perform some additional configurations. Then start the service in the Windows Services app.

Maintain the installation

You can uninstall the Tosca Server. For more information, see chapter "Maintain the Tosca Server installation".

Tosca Server Landing Page

The installation of the Tosca Server includes the installation of the Tosca Server Landing Page. This page allows you to access all server features through a single web interface and to monitor the availability of your installed services.

To access the page, type the following URL into a browser window: http://<server address>:<port>. If you use an HTTPS binding, enter https://<server address>:<port>.

  • Replace <server address> with the name of the host or the IP address of the server.

  • Replace <port> with the Gateway port.

This example uses an HTTPS binding, the server address localhost and port 443.


Tosca Server Landing Page