You are currently reviewing an older revision of this page.

[DRAFT] KB-XXXX How to modify existing ports in an on-premise Appian installation


Starting from Appian 17.3, Appian has default ports configured based on the Port Usage documentation. These default ports can be modified on an on-premise Appian installation.


Follow the steps provided below to modify default ports in an on-premise Appian installation:

Default Configuration

Component Default Port
Service Manager 7070
Zookeeper 2181, 2888, 3888
Kafka 9092
Search Server 9300
Data Server 5400-5405

All the default ports for the components mentioned above apart from the Service Manager port can be modified from the appian-topology.xml file.

<topology port="5000">
<search-cluster port="<NEW_SEARCH_SERVER_PORT>">
<broker host="localhost" port="<NEW_KAFKA_PORT>"/>
<zookeeper host="localhost" port="<NEW_ZOOKEEPER_PORT>"/>
<data-server host="localhost" port="<NEW_DATA_SERVER_PORT>" rts-count="1"/>

Service Manager

The default port for the Service Manager can be modified by specifying the following property in the file.


After making these changes, restart the environment to propagate the changes.


  1. Make sure that none of the new ports are the default ports of other components.
  2. Data Server port configuration is only available from Appian running 18.1 or later.
  3. If the environment is a distributed installation or running on a highly available configuration, ensure the appian-topology.xml file is the same on all servers.

Affected Versions

This article applies to all versions of Appian running 17.3 or later.

Last Reviewed: September 2018