Apache Tomcat is a web server and servlet container that is used to serve Java applications.
Run the following command to install the Tomcat package:
- sudo yum install tomcat -y
This will install Tomcat 7 and its dependencies, such as Java, and it will also create the
Most of the important Tomcat files will be located in
/usr/share/tomcat. If you already have a Tomcat application that you want to run, you can place it in the
/usr/share/tomcat/webapps directory, configure Tomcat, and restart the Tomcat service.
In this tutorial, however, we will install a few additional packages that will help you manage your Tomcat applications and virtual hosts.
Let’s make a quick change to the Java options that Tomcat uses when it starts. Open the Tomcat configuration file:
- sudo nano /usr/share/tomcat/conf/tomcat.conf
Add the following
JAVA_OPTS line to the file. Feel free to change the
MaxPermSize values—these settings affect how much memory Tomcat will use:
JAVA_OPTS="-Djava.security.egd=file:/dev/./urandom -Djava.awt.headless=true -Xmx512m -XX:MaxPermSize=256m -XX:+UseConcMarkSweepGC"
Save and exit.
Note that the Tomcat service will not be running yet.
Install Admin Packages
To install the default Tomcat root page (tomcat-webapps), and the Tomcat Web Application Manager and Virtual Host Manager (tomcat-admin-webapps), run this command:
- sudo yum install tomcat-webapps tomcat-admin-webapps -y
This adds the
host-manager web apps to the
Install Online Documentation (Optional)
If you want to install the Tomcat documentation, so that all of the links on the default Tomcat page will work, run this command:
- sudo yum install tomcat-docs-webapp tomcat-javadoc -y
Configure Tomcat Web Management Interface
In order to use the manager webapp installed in the previous step, we must add a login to our Tomcat server. We will do this by editing the
- sudo nano /usr/share/tomcat/conf/tomcat-users.xml
This file is filled with comments which describe how to configure the file. You may want to delete all the comments between the following lines, or you may leave them if you want to reference the examples:
<tomcat-users> ... </tomcat-users>
You will want to add a user who can access the
admin-gui (the management interface that we installed earlier). You can do so by defining a user similar to the example below. Be sure to change the username and password to something secure:
<tomcat-users> <user username="admin" password="password" roles="manager-gui,admin-gui"/> </tomcat-users>
Save and exit the
To put our changes into effect, restart the Tomcat service:
- sudo systemctl start tomcat
If you started the service earlier for some reason, run the restart command instead:
- sudo systemctl restart tomcat
Enable Tomcat Service
If you want Tomcat to run every time the server is booted up, you will need to enable the service:
- sudo systemctl enable tomcat
Access the Web Interface
Now that Tomcat is up and running, let’s access the web management interface in a web browser.
There are links to the admin webapps that you installed earlier.
Let’s take a look at the Manager App, accessible via the link or
The Web Application Manager is used to manage your Java applications. You can Start, Stop, Reload, Deploy, and Undeploy here. You can also run some diagnostics on your apps (i.e. find memory leaks).
Now let’s take a look at the Host Manager, accessible via the link or
From the Virtual Host Manager page, you can add virtual hosts to serve your applications from.