How to Install and Configure Apache Tomcat on an Ubuntu 18.04 VPS or Dedicated Server

How to Install and Configure Apache Tomcat on an Ubuntu 18.04 VPS or Dedicated Server


Web containers are applications written mainly to allow for running of Java code on the web server. It creates an environment for running java servlets and java server pages with the purpose of providing dynamic web content.

Apache Tomcat is one of the most popular Java web containers out there which is open source  because it offers almost all commercial features of a typical web application container. It offers some advantages, of course including:

  • Being open source, your rest assured Apache Tomcat is free for use.
  • Although Tomcat may not be feature rich, it is extremely lightweight.
  • The web container puts a lot of focus on stability hence you are sure that your application will rarely crush, and even in the event so, your server will continue to run just fine.

Before You Start


Update System Packages

$ sudo apt update -y && sudo apt upgrade -y

Install and Configure Java Environment

$ sudo apt install default-jre
$ sudo apt install default-jdk
$ java -versionopenjdk version "1.8.0_181"
OpenJDK Runtime Environment (build 1.8.0_181-8u181-b13-1ubuntu0.18.04.1-b13)
OpenJDK 64-Bit Server VM (build 25.181-b13, mixed mode)

Set your JAVA_HOME path

$ sudo sh -c 'echo export JAVA_HOME=/usr/lib/java-8-openjdk-adm64 > /etc/profile.d/'
$ source /etc/profile.d/
$ echo$JAVA_HOME

Install and configure Apache Tomcat

Download the latest version of Tomcat binary from the official site.

$ wget

Create a directory called tomcat or whatever you want (though relevant names are highly advised) in your /opt folder and extract the downloaded contents there.

$ sudo mkdir -p /opt/tomcat
$ sudo tar -xf apache-tomcat-9.0.12.tar.gz -C /opt/tomcat

Create a symbolic link so as to control the version release and updates.

$ sudo ln -s /opt/tomcat/apache-tomcat-9.0.12 /opt/tomcat/latest

Create a new user called tomcat and change ownership of the tomcat folder to the added user.

$ sudo useradd -r -m -U -d /opt/tomcat -s /bin/false tomcat
$ sudo chown -RH tomcat: /opt/tomcat/latest

Change the scripts in the binary folder to an executable mode

$ sudo chmod o+x /opt/tomcat/latest/bin/

To make the Tomcat service easily manageable, we will create a unit file and paste in the code below so as to run it as a service. Ensure to edit the JAVA_HOME path appropriately

$ sudo vim /etc/systemd/system/tomcat.service
Description=Tomcat 9 servlet container



Environment=" -Djava.awt.headless=true"

Environment="CATALINA_OPTS=-Xms512M -Xmx1024M -server -XX:+UseParallelGC"



Like any other service, start and enable Tomcat service.

$ sudo systemctl start tomcat
$ sudo systemctl enable tomcat
$ sudo systemctl status tomcat● tomcat.service - Tomcat 9 servlet container
   Loaded: loaded (/etc/systemd/system/tomcat.service; disabled; vendor preset: enabled)
   Active: active (running) since Wed 2018-11-0722:43:15 EAT; 1s ago
  Process:13927 ExecStart=/opt/tomcat/latest/bin/ (code=exited, status=0/SUCCESS)
 Main PID: 13938 (java)
   CGroup: /system.slice/tomcat.service
           └─13938/usr/lib/jvm/java-8-openjdk-amd64/bin/java -Djava.util.logging.config.file=/opt/tomcat/latest/conf/

Nov 0722:43:15 replicationserver systemd[1]: Starting Tomcat 9 servlet container...
Nov 0722:43:15 replicationserver[13927]: Tomcat started.
Nov 0722:43:15 replicationserver systemd[1]: Started Tomcat 9 servlet container.

Configure a username and password for accessing the web administration panel. These settings may be found in the tomcat-users.xmlfile.

$ sudo vim /opt/tomcat/latest/conf/tomcat-users.xml

Add the following block of code inside the tomcat-users element

<role rolename="administrator"/>
  <role rolename="manager"/>
  <user username="admin"password="admin123"roles="administrator,manager"/>

Exit while saving the changes. To enable remote access to the Managerand HostManager applications, edit both of the files context.xml i.e. the /opt/tomcat/latest/webapps/manager/META-INF/context.xml and /opt/tomcat/latest/webapps/host-manager/META-INF/context.xml to look like the code below while replacing the your appropriate IP address.

<Context antiResourceLocking="false" privileged="true" >
  <Valve className="org.apache.catalina.valves.RemoteAddrValve"
         allow="127.d+.d+.d+|::1|0:0:0:0:0:0:0:1|" />
  <Manager sessionAttributeValueClassNameFilter="java.lang.(?:Boolean|Integer|Long|Number|String)|org.apache.catalina.filters.CsrfPreventionFilter$LruCache(?:$1)?|java.util.(?:Linked)?HashMap"/>

Now restart Tomcat service.

$ sudo systemctl restart tomcat.

Head over to your browser and go to http://YOUR_IP_ADDRESS:8080 (use your IP address in place of the YOUR_IP_ADDRESS). You should see a screen similar to the one below.

How to Install and Configure Tomcat on Ubuntu 18


You have now installed Apache Tomcat. You can start doing your Java web development right away or explore the features to be offered. Remember Apache Tomcat is only as secure as you configure it.

A heavy burden of securing the application remains on the administrator, issues such as password policy can be the first important step to ensuring a safe web application container software.

Check out these top 3 Java hosting services:

$4.00 /mo
Starting price
Visit Kamatera
Rating based on expert review
  • User Friendly
  • Support
  • Features
  • Reliability
  • Pricing
$2.99 /mo
Starting price
Visit Hostinger
Rating based on expert review
  • User Friendly
  • Support
  • Features
  • Reliability
  • Pricing
$2.90 /mo
Starting price
Visit Ultahost
Rating based on expert review
  • User Friendly
  • Support
  • Features
  • Reliability
  • Pricing

How to Set Up WordPress Multisite on Ubuntu 18.04 with Apache Web Server

In this tutorial, we explain how to set up WordPress multisite on an Ubuntu 18.0
3 min read
Idan Cohen
Idan Cohen
Marketing Expert

How to Install a Let’s Encrypt Certificate on your Ubuntu 18.04 Dedicated Server or VPS

If you are hosting your website on a VPS server running Ubuntu 18.04, we will sh
3 min read
Michael Levanduski
Michael Levanduski
Expert Hosting Writer & Tester

How to Install WordPress with Nginx & Redis

This is an easy-to-follow guide written to help you learn how to install WordPre
5 min read
Max Ostryzhko
Max Ostryzhko
Senior Web Developer, HostAdvice CTO

How to Install Own Cloud On an an Ubuntu 18.04 Dedicated Server or VPS

You can create your own self-hosted cloud storage services by installing the ope
3 min read
Idan Cohen
Idan Cohen
Marketing Expert provides professional web hosting reviews fully independent of any other entity. Our reviews are unbiased, honest, and apply the same evaluation standards to all those reviewed. While monetary compensation is received from a few of the companies listed on this site, compensation of services and products have no influence on the direction or conclusions of our reviews. Nor does the compensation influence our rankings for certain host companies. This compensation covers account purchasing costs, testing costs and royalties paid to reviewers.
Click to go to the top of the page
Go To Top