Tosca Server configuration files
This topic lists the configurations you need to back up before you upgrade Tosca Server to version 2024.2. You have to back up manually if one of the following applies to you:
-
You upgrade from version 15.2 or older.
-
You upgrade from version 16.0 or newer, but the implicit upgrade didn't work.
In either case, you only need to back up the configurations of the Tosca Server features that you use.
List of files
Please note that instructions only apply to upgrades from these versions:
-
Versions that are supported around the time of the 2024.2 release: 2024.1 and 2023.2
-
Versions that are in extended support around the time of the 2024.2 release: 2023.1, 16.0, 15.2, and 15.0.
For information on how to organize upgrades for end-of-life versions, check out "Upgrade end-of-life versions".
![]() |
The paths in the table are the default paths after a default installation. Your actual paths may be different, depending on what you specified during the initial setup. |
Please choose your use case:

Tosca Server feature |
Required backup |
Default location |
---|---|---|
License administration |
appsettings.json |
C:\Program Files (x86)\TRICENTIS\Tosca Server\LicenseAdministration |
App_Data folder |
C:\Program Files (x86)\TRICENTIS\Tosca Server\LicenseAdministration |
|
Tosca Administration Console |
appsettings.json |
C:\Program Files (x86)\TRICENTIS\Tosca Server\ToscaAdministrationConsole |
Authentication Service
|
appsettings.json |
C:\Program Files (x86)\TRICENTIS\Tosca Server\AuthenticationService |
appsettings.Production.json |
C:\Program Files (x86)\TRICENTIS\Tosca Server\AuthenticationService |
|
Identity Management and UserData folders Make sure to also back up any data protection key files in the Identity Management folder. |
|
|
Tosca Distributed Execution |
Tricentis.DistributionServerService.exe.config |
C:\Program Files (x86)\TRICENTIS\Tosca Server\DEXServer |
appsettings.json |
C:\Program Files (x86)\TRICENTIS\Tosca Server\DexMonitor |
|
Automation Object Service (AOS) |
appsettings.json |
C:\Program Files (x86)\TRICENTIS\Tosca Server\AutomationObjectService |
Interactive Testing |
appsettings.json |
C:\Program Files (x86)\TRICENTIS\Tosca Server\InteractiveTestingStandalone |
Tricentis File Service |
appsettings.json |
C:\Program Files (x86)\TRICENTIS\Tosca Server\FileService |
Tricentis Test Data Service
|
appsettings.json |
C:\Program Files (x86)\TRICENTIS\Tosca Server\TestDataService |
TestDataService folder |
C:\ProgramData\TRICENTIS |
|
Database of the created repositories |
C:\ProgramData\TRICENTIS\ToscaServer\TestDataService |
|
Exploratory Testing Server |
Web.config |
C:\Program Files (x86)\TRICENTIS\Tosca Server\ExploratoryTestingServer |
server.db file and contents of the data folder |
C:\ProgramData\TRICENTIS\Exploratory Testing |
|
Tosca REST API Service
|
appsettings.json |
C:\Program Files (x86)\TRICENTIS\Tosca Server\RestApiService |
TCAPIRestServiceStandalone.dll.config |
C:\Program Files (x86)\TRICENTIS\Tosca Server\RestApiService |

Tosca Server feature |
Required backup |
Default location |
---|---|---|
License administration |
appsettings.json |
C:\Program Files (x86)\TRICENTIS\Tosca Server\LicenseAdministration |
App_Data folder |
C:\Program Files (x86)\TRICENTIS\Tosca Server\LicenseAdministration |
|
Tosca Administration Console |
appsettings.json |
C:\Program Files (x86)\TRICENTIS\Tosca Server\ToscaAdministrationConsole |
Authentication Service
|
appsettings.json |
C:\Program Files (x86)\TRICENTIS\Tosca Server\AuthenticationService |
appsettings.Production.json |
C:\Program Files (x86)\TRICENTIS\Tosca Server\AuthenticationService |
|
Identity Management and UserData folders Make sure to also back up any data protection key files in the Identity Management folder. |
|
|
Tosca Distributed Execution |
Tricentis.DistributionServerService.exe.config |
C:\Program Files (x86)\TRICENTIS\Tosca Server\DEXServer |
appsettings.json |
C:\Program Files (x86)\TRICENTIS\Tosca Server\DexMonitor |
|
Automation Object Service (AOS) |
appsettings.json |
C:\Program Files (x86)\TRICENTIS\Tosca Server\AutomationObjectService |
Interactive Testing |
appsettings.json |
C:\Program Files (x86)\TRICENTIS\Tosca Server\InteractiveTestingStandalone |
Tricentis File Service |
appsettings.json |
C:\Program Files (x86)\TRICENTIS\Tosca Server\FileService |
Tricentis Test Data Service
|
appsettings.json |
C:\Program Files (x86)\TRICENTIS\Tosca Server\TestDataService |
TestDataService folder |
C:\ProgramData\TRICENTIS |
|
Database of the created repositories |
C:\ProgramData\TRICENTIS\ToscaServer\TestDataService |
|
Exploratory Testing Server |
Web.config |
C:\Program Files (x86)\TRICENTIS\Tosca Server\ExploratoryTestingServer |
server.db file and contents of the data folder |
C:\ProgramData\TRICENTIS\Exploratory Testing |
|
Tosca REST API Service |
TCAPIRestServiceStandalone.exe.config * |
C:\Program Files (x86)\TRICENTIS\Tosca Server\RestApiService |
* As of 2024.1, REST API configurations are split between the appsettings.json and the TCAPIRestServiceStandalone.dll.config file, both located at C:\Program Files (x86)\TRICENTIS\Tosca Server\RestApiService. So, you need to back up TCAPIRestServiceStandalone.exe.config, but populate the new files after the upgrade.