Change the default AdminServer port
- Last Updated: August 19, 2025
- 2 minute read
- OpenEdge
- Version 12.8
- Documentation
You can change the default port, 20931, of the AdminServer using either of the
following ways, using a dedicated, minimally privileged service account:
- Updating the AdminServerPlugins.properties configuration file
- Using the proadsv utility
Note: Progress recommends changing the default AdminServer port to
a custom port as a security best practice. Attackers often use automated tools to
scan IP addresses for common services running on default ports. Changing the default
port increases the time it takes for automated network service attack to detect the
service.
Change the AdminServer port by updating the configuration file
To change the default port by updating the configuration file, perform the following steps
using a dedicated, minimally privileged service account:
- Stop the AdminServer. For more information, see Stop the AdminServer.
- Navigate to the location where the
AdminServerPlugins.properties file is placed.
- On Windows, go to: %DLC%\properties\AdminServerPlugins.properties
- On Linux, go to: $DLC/properties/AdminServerPlugins.properties
- Open the file using a text editor and locate the following sections:
- [PluginPolicy.Progress.AdminServer]
- [PluginPolicy.Progress.ProAdsv]
- To specify the new port number in both sections, add the following line:
port=<portnumber>For example, to set the port to 4321, update the file as follows:
% AdminServer Plugin Properties file ... [PluginPolicy.Progress.AdminServer] pluginclasspath=!{value-of:classpath} classpath=$DLC/java/... #In the following code snippet, the port sets the AdminServer rmi registry port number, the adminport sets the database plugin port, and the jvmargs sets the database log level to the maximum setting allowed. port=4321 [PluginPolicy.Progress.ProAdsv] classpath=${DLC}/java... pluginclasspath=!{value-of:classpath} port=4321 - Save the file and restart the AdminServer. For more information, see Start the AdminServer.
Change the AdminServer port using the PROADSV utility
To change the default port using the proadsv utility, perform the following
steps using a dedicated, minimally privileged service account:
- Launch the Proenv shell:
- On Windows, select Start > Programs (or All Programs) > Progress > OpenEdge , then right-click Proenv.
- On Linux, open a terminal and enter:
[installation-path]/bin/proenv
- To change the default AdminServer port, enter:
proadsv -start -port <new_port_number>
Note: When you update the port value using the
proadsv utility, the updated value overrides the value
already defined in the AdminServerPlugins.properties
file.