There is a new version of this tutorial available for Ubuntu 22.04 (Jammy Jellyfish).

How to install Tomcat in Ubuntu 14.04

Version 1.0
Author: Srijan Kishore
Last edited 21/Oct/2014

This document describes how to install Tomcat in Ubuntu 14.04. Apache Tomcat (or simply Tomcat, formerly also Jakarta Tomcat) is an open source web server and servlet container developed by the Apache Software Foundation (ASF). Tomcat implements the Java Servlet and the JavaServer Pages (JSP) specifications from Sun Microsystems, and provides a "pure Java" HTTP web server environment for Java code to run in. Apache Tomcat powers numerous large-scale, mission-critical web applications across a diverse range of industries and organizations. Some of these users and their stories are listed on the PoweredBy wiki page.

I do not issue any guarantee that this will work for you!

1 Preliminary Note

This tutorial is based on Ubuntu 14.04 server, so you should set up a basic Ubuntu 14.04 server installation before you continue with this tutorial. The system should have a static IP address. I use as my IP address in this tutorial and as the hostname.

2 Installation

To start the installation of Tomcat we need to first install java-1.7.0-openjdk, we will install it as follows:

apt-get install default-jdk

Check the version of java as follows:

java -version
[email protected]:~# java -version
java version "1.7.0_65"
OpenJDK Runtime Environment (IcedTea 2.5.1) (7u65-2.5.1-4ubuntu1~
OpenJDK 64-Bit Server VM (build 24.65-b04, mixed mode)
[email protected]:~#

Proceeding further we need some essential packages:

apt-get install unzip wget

Now we will download the latest Tomcat version from its home page and install it as:

cd /opt
mv apache-tomcat-8.0.9 tomcat

Configure .bashrc:

vi ~/.bashrc
export JAVA_HOME=/usr/lib/jvm/default-java/ export CATALINA_HOME=/opt/tomcat/

Restart the bash, to make the changes affective as:

. ~/.bashrc

Again before starting Tomcat service, we will provide executable permissions to following files:

chmod +x $CATALINA_HOME/bin/
chmod +x $CATALINA_HOME/bin/
chmod +x $CATALINA_HOME/bin/

Now we need to start Tomcat service by using:

[email protected]:~# $CATALINA_HOME/bin/
Using CATALINA_BASE:   /opt/tomcat/
Using CATALINA_HOME:   /opt/tomcat/
Using CATALINA_TMPDIR: /opt/tomcat//temp
Using JRE_HOME:        /usr/lib/jvm/default-java/
Using CLASSPATH:       /opt/tomcat//bin/bootstrap.jar:/opt/tomcat//bin/tomcat-juli.jar
Tomcat started.
[email protected]:~# 

It will start the Tomcat server, we can also check by using:

netstat -an | grep 8080
[[email protected] ~]# netstat -an | grep 8080
tcp6       0      0 :::8080                 :::*                    LISTEN    
[[email protected] ~]#

Now we need to setup the user account. Finally we need to create user accounts to secure and access admin/manager pages. Edit conf/tomcat-users.xml file in your editor and paste inside <tomcat-users> </tomcat-users> tags

vi  $CATALINA_HOME/conf/tomcat-users.xml

<!-- NOTE: The sample user and role entries below are wrapped in a comment and thus are ignored when reading this file. Do not forget to remove <!.. ..> that surrounds them. --> <!-- <role rolename="tomcat"/> <role rolename="role1"/> <user username="tomcat" password="tomcat" roles="tomcat"/> <user username="both" password="tomcat" roles="tomcat,role1"/> <user username="role1" password="tomcat" roles="role1"/> --> <role rolename="manager-gui"/> <role rolename="manager-script"/> <role rolename="manager-jmx"/> <role rolename="manager-status"/> <role rolename="admin-gui"/> <role rolename="admin-script"/> <user username="admin" password="admin" roles="manager-gui,manager-script,manager-jmx,manager-status,admin-gui,admin-script"/> </tomcat-users>

In above configuration I have used username=admin and password=admin, you can make the changes as per your choice. Then we need to stop/start the Tomcat service:

./bin/ stop
[[email protected] tomcat]# ./bin/ stop
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
[[email protected] tomcat]#

Then start the service:

./bin/ start
[[email protected] tomcat]# ./bin/ start
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
Tomcat started.
[[email protected] tomcat]#

Now access the page for login at

Your login password for the administrative right are as username=admin and password=admin.  Click on Manager App:

Congratulations we have a working Tomcat Server installed in Ubuntu 14.04 :)

Share this page:

Suggested articles

5 Comment(s)

Add comment


By: Ariel Cuenca

Srijan, thank you very much for this guide has been very useful


Ariel Cuenca

By: dave

Why do you need a static IP address, everything seems to work fine with an address of localhostThanks for writing an use guide.Dave

By: farzad

Your method is perfectly worked fo me. Thank you. 

By: Cristian

Awesome, thanks!

By: xingli

works great for me! Thank you so much for your detailed disciption!