XL Deploy configuration files

This topic describes the XL Deploy configuration files that can be found in the XL_DEPLOY_SERVER_HOME/conf folder


  • As of version 8.6, the system.conf, maven.conf, extenstions.conf, planner.conf, and scheduler.conf configuration files have been deprecated. The configuration properties from these files have been moved to the xl block of the xl-deploy.conf file.

    System.conf config migration

    Note For maven.conf file, the configuration is moved into xl.artifact.resolver.

    Config files migration

    The file xl-deploy.conf.example in the conf folder gives some examples of how to add the configuration files.

  • If you are upgrading to version 8.6 or higher and you have non-default configuration settings in the deprecated files, you must reconfigure these settings in the xl block in the xl-deploy.conf file.

List of configuration files

Configuration file name Description
xl-deploy.conf The file contains the main configuration used by the XL Deploy Server. This file is in HOCON format. After the first run, passwords in the configuration file will be encrypted and replaced with the base64-encoded encrypted values. Detailed properties descriptions are listed in the xl-deploy.conf.example that is located in the installation directory. Any changes on the properties inside xl-deploy.conf are applied only after a server restart.
xl-worker.conf This file is available for XL Deploy versions 8.6 and later. The configuration is used exclusively by an XL Deploy worker. This configuration is optional, worker configuration can be added to xl-deploy.conf. Configuration contains settings of worker hostname (xl.server.hostname) and port (xl.server.port).
deployit.conf Security and accessibility configuration settings generated on the XL Deploy server or CLI startup. The default location of the file is XL_DEPLOY_HOME/conf directory. Passing -configuration configuration_directory to the start script will change the location of the deployit.conf file. Detailed properties descriptions are listed in table below.
deployit-defaults.properties The default set of application configuration settings generated on the XL Deploy server or CLI startup. The main properties descriptions are listed in separate document.
maven.conf Configuration for the Maven repository by the maven-resolver extension. If you store artifacts in a Maven repository and use XL Deploy to deploy them, artifacts can be stored in a Maven repository using the fileUri property of XL Deploy artifacts.
planner.conf Configuration file defining planner related Akka properties. All rules are loaded from the xl-rules.xml file on the server startup. Adding the XL_DEPLOY_SERVER_HOME/ext/xl-rules.xml file and defining xl.file-watch.interval in planner.conf will automatically rescan the rules.
scheduler.conf Configuration file defining scheduler related Akka properties.
extensions.conf Configuration file defining the CIS export and import paths.
xld-wrapper-win.conf Windows Configuration used for running Wrapper. This configuration is set of JVM and application system properties.
xld-wrapper-linux.conf Linux Configuration used for running Wrapper. This configuration is set of JVM and application system properties.
logging.properties Configuration properties for logging.
system.conf Contains deprecated configuration which must be changed and merged to xl-deploy.conf.
logback-access.xml Logger configuration file for the access log.
logback.xml Logger configuration file for the XL Deploy Server or for the worker log.

List of configuration properties from the deployit.conf file

Configuration Key Configuration value Default value
admin.password Admin password used to access the system. value of this configuration item is encrypted. Notice: Admin password can be changed by writing plain text password and restarting the Server. After restarting the Server field be encrypted. -
http.context.root XL Deploy Server HTTP context root /
http.bind.address XL Deploy Server bind address
http.port XL Deploy server port 4516
http.welcome.page Set default Web Welcome page. -
http.idle.seconds Timeout before idle HTTP connections are discarded.
http.upload.buffer Uploaded files buffer. 262144
client.automatically.map.all.deployables When set to “true”, all deployables will be auto-mapped to containers when you set up an initial or update deployment in the GUI. true
client.automatically.map.all.deployables.on.initial When set to “true”, all deployables will be auto-mapped to containers only when you set up an initial deployment in the GUI. false
client.automatically.map.all.deployables.on.update When set to “true”, all deployables will be auto-mapped to containers only when you set up an update deployment. false
client.session.timeout.minutes Number of minutes before a user’s session is locked when the GUI is idle. 20
client.session.remember.enabled Show or hide the Keep me logged in option on the log-in screen. true
client.server_poll.delay Delay on client for starting polling on server. 30000
jcr.repository.path JCR repository location XL_DEPLOY_SERVER_HOME/repository
hide.internals Hide or show any internal server errors due to incorrect user input. false
server.resolve.application.dependencies Enable server resolved application dependencies true
threads.max Maximum number of threads for XL Deploy to use. 150
threads.min Minimal number of threads for XL Deploy to use. 30
maintenance.forbidden_paths Disabled paths on XL Deploy Server context deployit/task\:POST,deployit/tasks/v2\:POST,deployit/control\:POST
ssl Turn the SSL support on. false
ssl.mutual Use mutual SSL Trust Store. false
ssl.protocol Protocol to use for SSL -
keystore.path SSL Keystore path -
truststore.path Trust Store path (has to be set if mutual SSL switch is enabled) -
truststore.password Trust Store password. -
secure.cookie.enabled Enable secure cookies. false
server.mapping.override.deployed.fields.on.update Use default deployable properties setter. true
importable.packages.path Path to importable packages from the XL Deploy Server importablePackages

For a detailed list of xl-deploy.conf properties, see the xl-deploy.conf.example file in the XL_DEPLOY_SERVER_HOME\conf folder.