Older versionVersion 1.5.0SolutionsChange default HTTP port in PhenixID Server

Change default HTTP port in PhenixID Server

PhenixID Server will by default start HTTP services on port 8443. This article describes how to change default http port.

System requirements

PhenixID Server installed.


This article describes how to change default http port 8443 in PhenixID Server.

Changing the port

Before doing any changes to the respective configuration files, please make sure that you have a recent copy/backup of these files.

The primary change for this port should be done during installation. If this is not done it can be changed in the file /config/boot.json after installation in the sections:

"module": "com.phenixidentity~phenix-prism",
            "enabled": "true",
            "config": {
                "_auth_redirect_url": "/config/authenticate/config",
                "base_url": "/config",
                "ssl": "true",
                "port": "1789"
"module": "com.phenixidentity~auth-http",
            "enabled": "true",
            "config": {
                "ssl": "true",
                "port": "1789"

After changes to the file boot.json, please restart the service.


Besides this, some additional configuration might be needed to make sure that this port is not bound by the service.

Any module added to the configuration (located in the file /config/phenix-store.json) that uses HTTP will by default use port 8443.

So for these modules we need to add the parameter "port" to the configuration of that specific module.

Versions of PhenixID Server starting the CA module will need to have the port parameter set like this example:

"module" : "com.phenixidentity~phenix-ca~1.5.1",
      "enabled" : "true",
      "config" : {
        "node_id" : "PhenixID01",
        "port" : "1789"

When configuring the Scenarios PhenixID Self Service and/or OTP Admin, modules starting HTTP listener will be added.

To make sure they will not use port 8443, add the "port" parameter like this example:

"module" : "com.phenixidentity~phenix-prism~1.5.1",
      "enabled" : "true",
      "config" : {
        "base_url" : "/otpenrollment",
        "port" : "1789",

So to make sure that only a specific port should be bound on the server, make sure that the parameter "port" is set on the respective modules.