Additional menu

Apache Tomcat Hardening and Security Guide

Apache Tomcat Hardening and Security Guide

A practical guide to hardening and secure Apache Tomcat Server with the best practices.

Tomcat is one of the most popular Servlet and JSP Container servers. It’s used by some of following high traffic websites:


Below chart shows the market position of Tomcat in Java application server.

Source: Plumbr

Technically, you can use Tomcat as a front-end server to serve site requests directly. However, in a production environment, you may want to use some web servers like Apache, Nginx as front-end to route the requests to the Tomcat.

Using web server to handle the requests gives performance and security benefits. If you are using Apache HTTP as a front-end web server, then you must consider securing that as well.

Having default Tomcat configuration may expose sensitive information, which helps hacker to prepare for an attack the application.

Following are tested on Tomcat 7.x, UNIX environment.


This is designed for Middleware Administrator, Application Support, System Analyst or anyone working or eager to learn Tomcat Hardening and Security.

Fair knowledge of Tomcat & UNIX command is mandatory.


We require some tool to examine HTTP Headers for verification. There are two ways you can do this.

If testing Internet-facing application then you may use the following HTTP Header tools to verify the implementation.

And for an Intranet application, you may use Google Chrome, Firefox developer tools.

As a best practice, you must take backup of any file you are about to modify.

We will call Tomcat Installation folder as $tomcat throughout this guidelines.

Let’s go through the hardening & securing procedures.

1. Remove Server Banner

Removing Server Banner from HTTP Header is one of the first things to do as hardening.

Having server banner expose the product and version you are using and leads to information leakage vulnerability.

By default, a page served by Tomcat will show like this.

Let’s hide the product and version details from Server header.

  • Go to $tomcat/conf folder
  • Modify server.xml by using vi
  • Add following to Connector port
Server =” “

Ex: –

<Connector port="8080" protocol="HTTP/1.1" 
Server =" "
redirectPort="8443" />
  • Save the file and restart the Tomcat. Now, when you access an application, you should see blank value for Server header.

2. Starting Tomcat with a Security Manager

Security Manager protects you from an untrusted applet running in your browser.

Running Tomcat with a security manager is better than running without one. Tomcat has excellent documentation on Tomcat Security Manager.

The good thing about this is you don’t need to change any configuration file. It’s just the way you execute file.

All you got to do is to start tomcat with –security argument.

[[email protected] bin]# ./ -security
Using CATALINA_BASE: /opt/tomcat
Using CATALINA_HOME: /opt/tomcat
Using CATALINA_TMPDIR: /opt/tomcat/temp
Using JRE_HOME: /usr
Using CLASSPATH: /opt/tomcat/bin/bootstrap.jar:/opt/tomcat/bin/tomcat-juli.jar
Using Security Manager
Tomcat started.
[[email protected] bin]#

4. Enable SSL/TLS

Serving web requests over HTTPS is essential to protect data between client and Tomcat. In order to make your web application accessible through HTTPS, you need to implement SSL certificate.

Assuming, you already have keystore ready with the certificate, you can add below line in server.xml file under Connector port section.

SSLEnabled="true" scheme="https" keystoreFile="ssl/bloggerflare.jks" keystorePass="chandan" clientAuth="false" sslProtocol="TLS"

Change the Keystore file name and password with yours.

If you need help with keystore & CSR process then refer to this guide.

5. Enforce HTTPS

This is only applicable when you’ve SSL enabled. If not, it will break the application.

Once you’ve enabled SSL, it would be good to force redirect all HTTP requests to HTTPS for secure communication between user to Tomcat application server.

  • Go to $tomcat/conf folder
  • Modify web.xml by using vi
  • Add following before </web-app> syntax
<web-resource-name>Protected Context</web-resource-name> 
  • Save the file and restart the Tomcat

6. Add Secure & HttpOnly flag to Cookie

It is possible to steal or manipulate web application session and cookies without having a secure cookie. It’s a flag which is injected in the response header.

This is done by adding below line in session-config section of web.xml file


Configuration screenshot:

Save the file and restart Tomcat to examine the HTTP response header.

7. Run Tomcat from non-privileged Account

It’s good to use a separate non-privileged user for Tomcat. The idea here is to protect other services running in case of any of account get compromised.

  • Create a UNIX user, let’s say tomcat
useradd tomcat
  • Stop the Tomcat if running
  • Change $tomcat ownership to user tomcat
chown -R tomcat:tomcat tomcat/

Start the Tomcat and ensure it’s running with tomcat user

8. Remove default/unwanted Applications

By default, Tomcat comes with following web applications, which may or not be required in a production environment.

You can delete them to keep it clean and avoid any known security risk with Tomcat default application.

  • ROOT – Default welcome page
  • Docs – Tomcat documentation
  • Examples – JSP and servlets for demonstration
  • Manager, host-manager – Tomcat administration

They are available under $tomcat/webapps folder

[[email protected] webapps]# ls -lt
drwxr-xr-x 14 tomcat tomcat 4096 Sep 29 15:26 docs
drwxr-xr-x 7 tomcat tomcat 4096 Sep 29 15:26 examples
drwxr-xr-x 5 tomcat tomcat 4096 Sep 29 15:26 host-manager
drwxr-xr-x 5 tomcat tomcat 4096 Sep 29 15:26 manager
drwxr-xr-x 3 tomcat tomcat 4096 Sep 29 15:26 ROOT
[[email protected] webapps]#

9. Change SHUTDOWN port and Command

By default, tomcat is configured to be shutdown on 8005 port.

Do you know you can shutdown tomcat instance by doing a telnet to IP:port and issuing SHUTDOWN command?

Chandans # telnet localhost 8005
Trying ::1... telnet:
connect to address ::1:
Connection refused Trying
Connected to localhost.
Escape character is '^]'.
SHUTDOWN Connection closed by foreign host.
Chandans #


You see having default configuration leads to high-security risk.

It’s recommended to change tomcat shutdown port and default command to something unpredictable.

  • Modify the following in server.xml
<Server port="8005" shutdown="SHUTDOWN">

8005 – Change to some other unused port

SHUTDOWN – Change to something complicated


<Server port="8867" shutdown="NOTGONNAGUESS">

10. Replace default 404, 403, 500 page

Having default page for not found, forbidden, server error exposes version details.

Let’s look at default 404 page.

To mitigate, you can first create a general error page and configure web.xml to redirect to general error page.

  • Go to $tomcat/webapps/$application
  • Create an error.jsp file using vi editor
<title>Error Page</title>
<body> That's an error! </body>
  • Go to $tomcat/conf folder
  • Add the following in web.xml file. Ensure you add before </web-app> syntax
  • Restart tomcat server to test it

Much better!

You can do this for java.lang.Exception as well. This will help in not exposing tomcat version information if any java lang exception.

Just add following in web.xml and restart tomcat server.


I hope above guide gives you an idea no securing Tomcat. If you are looking to learn more about Tomcat administration then check out this online course.

Reader Interactions

Chandan Kumar
About Chandan
Chandan Kumar is the founder and editor of Geek Flare. Learn more here and connect with him on Twitter.


  1. The secure flag on a server does something else than described in this article. When using this guide: please doublecheck with the actual tomcat documentation.

  2. Good guide. One additional point is that when you’re hiding the error messages, you should look to catch 501 (Not implemented) as well, as it’s pretty easy to get the server to generate a 501 message, by changing the HTTP verb to one not implemented.

  3. Above security implementations works fine in production environment.
    But this hardened version of tomcat doesn’t work with eclipse. (timeout error)

  4. Great guide! However, I have a question on #5 (Add Secure flag in cookie)

    Why not set all “” inside each webapp’s web.xml file or tomcat/conf/web.xml file? Is there a difference between using session-config and connector?



  5. > “As you can see tomcat information is no more exposed.”
    Well, except for the tomcat icon (.ico) in the browser tab in your example image to the left of where it says 404-Page Not Found in section 11 🙂 That ico is a picture of a cat, the tomcat.

Leave a Reply

Your email address will not be published. Required fields are marked *