VisibleThread -
Help Center Find helpful articles on different VisibleThread Products


How to change Tomcat application server port.

Note: This can only be done with VT Docs version 3.2.2

Out of the box, our Tomcat application server runs on port 8080. We also have an Apache web server acting as a reverse proxy into Tomcat - this runs on port 443 (https). 

If you wish to configure Tomcat to run on another port and configure Apache to reverse proxy to this other port. To implement this you will need to :

1. Edit the Tomcat config:

For Ubuntu deployments the file location is: /home/visiblethread/tomcat/conf/server.xml

For Red Hat deployments the file location is: /opt/visiblethread/tomcat/conf/server.xml

Find & change the port e.g.

<Connector port="8081" protocol="HTTP/1.1"

2. Edit the Apache config:

For Ubuntu deployments the file location is: /etc/apache2/sites-enabled/000-default.conf

For RedHat deployments the file location is: /etc/httpd/conf.d/visiblethread.conf

In here you need to change the ProxyPass and ProxyPassReverse to match the port you have chosen in the server.xml file. See example below, notice the ports below match the connector port above 8081.

ProxyPass / http://localhost:8081/
ProxyPassReverse / http://localhost:8081/

3. Restart Tomcat and Apache:

Ubuntu Deployments

service supervisor restart && service apache2 restart

Red Hat deployments

service httpd restart && service visiblethread-docs restart

Now that you have changed the port it is advised that you log into the application and run the following functional tests:

Upload a document, Generate a compliance matrix, Generate a PDF via export

If you run into trouble or have any questions you can get in touch with us at

Was this article helpful?
0 out of 0 found this helpful

Get Additional Help

Visit our Helpdesk for additional help and support.