Change Ports and URLs in Pentaho BI

The Pentaho Server has associated default port numbers. You can change these port numbers to adjust the Pentaho Server to your system. Since the port number of the Pentaho Server is a part of its URL, you will also have to change that address.

Change Pentaho Server (Tomcat) Port Numbers

Edit the /pentaho/server/pentaho-server/tomcat/conf/server.xml file and change the port numbers as shown in the following example code:


<Connector URIEncoding=”UTF-8″ port=”8080″ protocol=”HTTP/1.1″


redirectPort=”9443″ />

<!– A “Connector” using the shared thread pool–>

<Connector URIEncoding=”UTF-8″ executor=”tomcatThreadPool”

port=”8080″ protocol=”HTTP/1.1″


redirectPort=”9443″ />

Replace the port number from 8080 to desired port.

Save and close the file.

You may also have to change the SSL and SHUTDOWN ports in this file, depending on your configuration.

Next, follow the directions in Change the Pentaho Server URL to accommodate for the new port number.

Change the Pentaho Server URL

You can change the Pentaho Server hostname from localhost to a specific IP address, hostname, or domain name by following these instructions. This procedure is also a requirement if you are changing the Pentaho Server port number.


  1. Stop the Pentaho Server.
  2. Navigate to the pentaho/server/pentaho-server/pentaho-solutions/system directory and open the file with any text editor.
  3. Modify the value of the fully-qualified-server-url element appropriately.
    1 fully-qualified-server-url=http://localhost:8080/pentaho/
  4. Save and close the file.
  5. Start the Pentaho Server.

The Pentaho Server is now configured to reference itself at the specified URL.

Note: If you recently upgraded to Pentaho 6.x or higher from a version earlier than 6.0, you may need to remove the <context-param> entry for the fully-qualified-server-url from the /tomcat/webapps/pentaho/WEB-INF/web.xml. If so, restart the Pentaho Server after removing it.