Free cookie consent management tool by TermsFeed Custom Configurations [Server Administration]
Custom Configurations


Appian uses .properties and .xml files to set or modify standard configuration settings. This page describes how to set custom parameters in these files so that your customizations are retained whenever Appian is updated.

Custom properties

Most system settings can be centrally managed by configuring a single properties file called located at <APPIAN_HOME>/conf/. In multiple server environments, the contents of this file must be identical on all Appian servers.

  • The file you create is not overwritten when an upgrade occurs.

A file is installed in the same directory to provide you with general examples. Be sure you are familiar with each setting in the example file before implementing its settings.

  • If you enable the settings listed in this example file without configuring it properly for your environment, the Appian Engines may not start.

Most properties can safely be left at their default settings. For any properties that must be set for the system to work correctly, see also: Required Configurations.

Once the file is created and Appian is running, some properties can be read dynamically while others require the application server to restart.

The table below lists the various property prefixes and whether or not changes to them require the Application Server to be restarted to have the changes take effect.

Property Prefix Application Server Restart Needed
conf.forms.* No
conf.mailhandler.* No
conf.node.webservice.* No* No* No* No
resources.appian.applications.applications.* No* No* No
server.conf.* No
All other prefixes Yes

Logging options

The filenames, locations, and content of log files can be configured using file.

See also: Customizing Log Output

Server configurations

Appian allows you to manage server configurations using a custom topology file. An example file named appian-topology.xml.example is included in the following location:

  • <APPIAN_HOME>/conf/

Common uses for a custom topology configuration file include:

Custom Configurations