Skip to main content


Setting Up OutSystems




Configuration Tool Command Line Reference

This article applies to: OutSystems 11  Other versions available: 10

The Configuration Tool allows you to configure your OutSystems server.

The default path of the Configuration Tool command line is the following:

C:\Program Files\OutSystems\Platform Server\

The Configuration Tool command line returns non-zero values when an error occurs.

Syntax {/SetupInstall <platform_db_admin_username> <platform_db_admin_password> <logging_db_admin_username> <logging_db_admin_password> [/SetPlatformServerAdminPassword <platform_server_admin_password>] | /UpgradeInstall [<admin_password>] [/SetPlatformServerAdminPassword <platform_server_admin_password>]} [/RebuildSession <session_db_admin_username> <session_db_admin_password>] [/SCInstall] [/CreateUpdateCacheInvalidationService]
    | /GenerateTemplates
    | /ClearInternalNetwork
    | /UploadLicense <license_file>
    | /RegenerateSettingsKey
    | /GetSerial
    | /GetDeploymentZones
    | /ModifyDeploymentZone <configuration_name> <zone_address> [<enable_https>]


/SetupInstall [<platform_db_admin_username> <platform_db_admin_password>] [<logging_db_admin_username> <logging_db_admin_password>]

Creates or upgrades the OutSystems platform and logging database model using the server.hsconf configuration file.

For SQL Server of Azure SQL databases, you must provide the credentials needed to create or upgrade the platform database. Furthermore, if you specify separate platform and logging databases in server.hsconf, you also need to provide the credentials needed to create or upgrade the logging database.

For Oracle databases, you do not need to provide the admin usernames and passwords.

/UpgradeInstall [<admin_password>]

Upgrades the OutSystems platform and logging database models, without validating if the database exists or if the permissions are correct.

The admin password is optional and is only used for integrated authentication purposes where the password isn't stored in the server configuration file.

/RebuildSession <session_db_admin_username> <session_db_admin_password>

Upgrades the session database model. The username and password provided must belong to a user with permissions to execute these operations.


Forces the Service Center installation to run after finishing Configuration Tool.


Generates server configuration file (.hsconf) templates for each supported database engine in Platform Server\docs.


Resets the internal network settings so that internal applications become accessible from any origin.

/UploadLicense <license_file>

Uploads the license file and checks if the license is valid.


Generates a new private.key file.


Prints the serial number of this installation.


Lists the configured deployment zones for the current installation. The data is presented in JSON format, limited to the relevant settings that can be manipulated with /ModifyDeploymentZone, namely: the Configuration Name and Address, and it's Enable HTTPS status.

/ModifyDeploymentZone <configuration_name> <zone_address> [<enable_https>]

Modifies the Address and/or Enable HTTPS settings of a Deployment Zone.

<configuration_name> is the Deployment Zone that you want to modify; this argument is case insensitive (for example "GLOBAL" will map to "Global").

<zone_address> is the new address for the target Deployment Zone.

[<enable_https>] is an optional boolean argument; if this argument is not provided the setting will remain unchanged. If the string "true" (case insensitive) is provided, the Enable HTTPS setting is set to "true"; if any other string is provided the setting Enable HTTPS is set to "false". The applied value of the Enable HTTPS setting is displayed.


Installs cache invalidation service or reconfigures the service given in the configuration file (server.hsconf).

/SetPlatformServerAdminPassword <platform_server_admin_password>

Defines the password for the Platform Server Admin user, if the user is active.
Note: This command does not work when using Integrated Authentication.


Perform a clean installation for SQL Server or Azure SQL:
    /SetupInstall <platform_db_admin_username> <platform_db_admin_password> <logging_db_admin_username> <logging_db_admin_password>
    /RebuildSession <session_db_admin_username> <session_db_admin_password>

Perform a clean installation for Oracle:
    /RebuildSession <session_db_admin_username> <session_db_admin_password>

Perform an upgrade from OutSystems 10 (or lower):
    /UpgradeInstall [<admin_password>]
    /RebuildSession <session_db_admin_username> <session_db_admin_password>

Perform an upgrade from OutSystems 11:
    /UpgradeInstall [<admin_password>]
    /RebuildSession <session_db_admin_username> <session_db_admin_password>

Modify the Address and/or Enable HTTPS settings of the "Global" deployment zone:
    /ModifyDeploymentZone "Global" <zone_address> [<enable_https>]


By default, the Configuration Tool has logging enabled with log level 4 (Verbose), and the predefined log file is defined as C:\Windows\Temp\ConfigurationTool.log.

For more information on configuring logs check the Change OutSystems Platform logging levels (OSTrace) topic.