Back to home

Tomcat Manager Application for Tomcat 8 + 9


Your instances do not come with the Tomcat 8 Manager Application or Tomcat 9 Manager Application application out of the box.

We’ll first have to extract this application from a fresh Tomcat 8 installation archive, and to copy it in our instance (this application is unfortunately not available in a standalone version). We’ll then set a tomcat user with the correct credentials to access it.

What version of Tomcat am I using?

First of all, we need to know what Tomcat version we are on.
Launch the following command to know what is the current version of Tomcat on your system:

java -cp /usr/share/tomcat8/lib/catalina.jar org.apache.catalina.util.ServerInfo | grep "Server number"
# Server number:


java -cp /usr/share/tomcat9/lib/catalina.jar org.apache.catalina.util.ServerInfo | grep "Server number"
# Server number:

In the example above, we are using Tomcat We’ll therefore download the correct Tomcat 9 archive in the next step.

Getting the application

All the Tomcat versions are located here: Browse the version you need, and replace it in the code snippet below:

cd ~/<instance-name>/
tar xvf apache-tomcat-9.0.16.tar.gz
mv apache-tomcat-9.0.16/webapps/manager/ webapps/
rm -rf apache-tomcat-9.0.16*

Setting up the credentials

As specified in the reference documentation, we first need to create a manager.xml file in ~/<instance-name>/conf/Catalina/localhost/:

<?xml version="1.0" encoding="UTF-8"?>
<Context path="/manager" antiResourceLocking="false" privileged="true" />

As a second step, we need to add our user to ~/<instance-name>/conf/tomcat-users.xml:

<role rolename="manager-gui"/>
<user username="manager" password="random-password" roles="manager-gui"/>

After this changes, restart your instance:

systemctl --user restart user-tomcat@<instance-name>

The Tomcat Manager Application should now be accessible under with the credentials mentioned in tomcat-users.xml.

Didn't find what you were looking for?

Contact our support:

+41 44 637 40 40 Support Portal