Apache tomcat install windows

Note: Take a look at our list of 13 best Java IDEs, which help write, debug, and test Java code.

Important: Back up the .xml files before making any changes.

Note: If you are looking for a different operating system, our Knowledge Base also has a tutorial on how to install Tomcat on Ubuntu.

Was this article helpful?

YesNo

Last Updated :
19 Jan, 2023

Apache Tomcat which is short for “Tomcat” is a free, open-source Java Servlet, Java Expression Language, JavaServer Pages, and WebSocket implementation. Tomcat is an HTTP web server that basically runs Java code in a “pure Java” environment. Here, we will see how to install Tomcat 10 on Windows 10 from Zip Archive. Requirements are Java 8 or above must be already installed. Make sure Windows Firewall allows Tomcat application.   

Installing Apache Tomcat on Windows

Step 1: We need to first install the Tomcat 10 zip file from this website. On the website, select the 64-bit Windows zip (PGP, sha512) in the Core section to start the download process for the Tomcat zip file. 

Картинка с сайта: www.geeksforgeeks.org

Step 2: Check If JDK Is Installed. Open Command Prompt and enter the following commands

java -version
javac -version

Картинка с сайта: www.geeksforgeeks.org

If JDK is not installed on your computer, install JDK. In the above picture, we can see JDK is already installed on our computer. 

Step 3: Unzip Tomcat 10 Zip File. Go to the location where you have downloaded the Tomcat 10 zip file. Right-click on the apache tomcat file place the cursor on 7-Zip and click on Extract Here to extract the folder.  

Картинка с сайта: www.geeksforgeeks.org

Step 4: Creating JAVA_HOME Variable. Click Start then in the search bar, search for “Edit the system environment variables” and click on it. The following System Properties box will open. Select Environment Variables in the box. 

Картинка с сайта: www.geeksforgeeks.org

On clicking Environment Variables the following box will open.

Картинка с сайта: www.geeksforgeeks.org

Step 5: We have to create a JAVA_HOME variable and insert the path of the JDK file stored in our computer, which will be shown below. So select New from the System variables in the above picture. A New System Variable box will be opened where we will have to fill in the Variable name and Variable value.

Картинка с сайта: www.geeksforgeeks.org

Step 6: Go to the location where you have stored the contents of the JDK file in My Computer or PC. Copy the root path of the location of the JDK file as shown below.

Картинка с сайта: www.geeksforgeeks.org

Step 7: Paste the JDK path from the above picture into the Variable value field and in the Variable name field, give the name JAVA_HOME as shown below. 

Картинка с сайта: www.geeksforgeeks.org

Step 8: Check the Working of Tomcat. Open the extracted apache tomcat file. We will see all the following files in them. Among them open the batch file named “startup”. 

Картинка с сайта: www.geeksforgeeks.org

Step 9: Check if the Startup Windows Batch File is running properly. 

Картинка с сайта: www.geeksforgeeks.org

By default, the server port number is 8080.

Step 10: Successful Installation of Tomcat. Our next step is to open an internet browser like Google and type in the address 

http://localhost:8080

Then click enter and the following browser will appear suggesting the successful installation of Apache Tomcat. 

Картинка с сайта: www.geeksforgeeks.org

Since this article was first written, Lucee has a Windows Installer which installs Tomcat with Lucee.

Before we start with the installation, we need to dive into some basics:

What we don’t like

• A mix of binaries (exe, dll-files) and configuration data (eg. XML files) in the application directory
• The software needs change permissions to write data into his application directory
• A windows service needs System Authority permissions

What we really like

• The application can live perfectly with read permissions in its application directory
• The data of the application can be stored in a data directory on a different drive as C-drive
• A windows service can run with a low privileged user permissions

This guide will fully cover a setup of Apache Tomcat to fulfill these goals from What we really like above.

In terms of Apache Tomcat, we split the files by setting Tomcat’s main variables to the Application path and Data path later on:

catalina.home=C:\Program Files\Tomcat
catalina.base=D:\Tomcat

Before we start, let’s download Apache Tomcat from this page: Tomcat 8 Downloads. Scroll down a bit and choose the link 64-bit Windows zip. Download the product and unzip the content to a temporary folder on your server.

Installation

1. Create the folders C:\Program Files\Tomcat, C:\Program Files\Tomcat\bin and C:\Program Files\Tomcat\lib
2. Browse the expanded content in your temporary folder and change into the folder apache-tomcat-8.0.18.
3. Copy the five files from the root in to the folder C:\Program Files\Tomcat
4. Goto the folder named bin.
5. Copy all files, except *.bat, *.gz and *.sh to the folder C:\Program Files\Tomcat\bin. We don’t need the batch files: The Tomcat service will get his configuration from the Windows registry instead.
6. Go back one level and goto to the folder named lib
7. Copy all files to the folder C:\Program Files\Tomcat\lib

That’s it, at least for the application folder. Tomcat requires approximately 10MB of diskspace.

Command line:

md "C:\Program Files\Tomcat"
copy D:\temp\apache-tomcat-8.0.18\*.* "C:\Program Files\Tomcat" /Y

md "C:\Program Files\Tomcat\bin"
copy D:\temp\apache-tomcat-8.0.18\bin\*.exe "C:\Program Files\Tomcat\bin" /Y
copy D:\temp\apache-tomcat-8.0.18\bin\*.dll "C:\Program Files\Tomcat\bin" /Y
copy D:\temp\apache-tomcat-8.0.18\bin\*.jar "C:\Program Files\Tomcat\bin" /Y
copy D:\temp\apache-tomcat-8.0.18\bin\*.xml "C:\Program Files\Tomcat\bin" /Y

md "C:\Program Files\Tomcat\lib"
copy D:\temp\apache-tomcat-8.0.18\lib\*.jar "C:\Program Files\Tomcat\lib" /Y

Note: You can paste the content of the container above directly into the command line of the server.

Now lets do the same for the configuration and data folder:

1. Create the folders: D:\Tomcat, D:\Tomcat\conf and D:\Tomcat\webapps.
2. Goto the folder named conf.
3. Copy all files to the folder D:\Tomcat\conf
4. Create the folders D:\Tomcat\webapps\host-manager, D:\Tomcat\webapps\manager and D:\Tomcat\webapps\ROOT.
5. Goto the folder named webapps.
6. Copy the folders host-manager, manager and ROOT to the matching folder on the target. All these folders have subfolders.
7. Create the folders D:\Tomcat\logs, D:\Tomcat\endorsed, D:\Tomcat\temp and D:\Tomcat\work. Some of these directories remain empty until the very first start of Tomcat.

Command line:

md D:\Tomcat
md D:\Tomcat\conf
copy D:\temp\apache-tomcat-8.0.18\conf\*.* D:\Tomcat\conf /Y

md D:\Tomcat\webapps
md D:\Tomcat\webapps\host-manager
xcopy D:\temp\apache-tomcat-8.0.18\webapps\host-manager\*.* D:\Tomcat\webapps\host-manager /s /Y
md D:\Tomcat\webapps\manager
xcopy D:\temp\apache-tomcat-8.0.18\webapps\manager\*.* D:\Tomcat\webapps\manager /s /Y
md D:\Tomcat\webapps\ROOT
xcopy D:\temp\apache-tomcat-8.0.18\webapps\ROOT\*.* D:\Tomcat\webapps\ROOT /s /Y

md D:\Tomcat\endorsed
md D:\Tomcat\logs
md D:\Tomcat\temp
md D:\Tomcat\work

We finished the basic installation. Now we have to edit some of the configuration files.

Let’s go to the folder D:\Tomcat\conf.

server.xml

Catalina’s default host needs some tweaking. Find the line:

<Host name="localhost" appBase="webapps"
            unpackWARs="true" autoDeploy="true">

Change this line to:

<Host name="localhost" appBase="D:\Tomcat\webapps" workDir="D:\Tomcat\work\Catalina\localhost" unpackWARs="true" autoDeploy="true">

A few lines below, you will find the line:

<Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"

We need to specify the full path to the log directory:

<Valve className="org.apache.catalina.valves.AccessLogValve" directory="D:\Tomcat\logs"

The next step is optional. Tomcat and Lucee are listening on port 8080 to access the administrator interface. Other web servers might use this port already or if you suffer from a security paranoia like i do, we want to have this port on a really weard number.

Note: The Lucee’ians are used to have port 8888 to access the administrator interface.

Find the setting:

<Connector port="8080" protocol="HTTP/1.1"
               connectionTimeout="20000"
               redirectPort="8443" />

Change the port 8080 to the new port.

If you like to access the Tomcat Administration from outside of the server, the Windows firewall needs to be opened with a rule:

netsh advfirewall firewall add rule name="Apache Tomcat" dir=in action=allow protocol=TCP localport=8888 program="C:\Program Files\Tomcat\bin\tomcat8.exe" profile=ANY

You don’t like the command prompt? Add the rule with the firewall applet in the control panel.
Be sure, that the port is limited to the main exe file C:\Program Files\Tomcat\bin\tomcat8.exe.

Todo: maxHttpHeaderSize=»8192″ (Default: 4096)
minSpareThreads=»25″ (Default: 4)
disableUploadTimeout=»true» (Default: false)

tomcat-users.xml

This file holds rules, usernames and passwords to access the administrator interface of Tomcat. The access to the administrator interface is disabled by default:

<!--
  <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"/>
-->

Replace the content with this:

<role rolename="admin-gui"/>
<role rolename="manager-gui"/>
<user name="AccountName" password="VeryStrongPassword" roles="admin-gui,manager-gui" />

Choose a clever name for the administrator account. For security reasons, do not choose admin or administrator!
The password should contain a mix between upper- and lower-case letters, numbers and special characters like _-!.

catalina.properties

This is an optional task, which cuts the time Tomcat takes to start:

Find the line:

tomcat.util.scan.StandardJarScanFilter.jarsToSkip=\

Remove the lines below until the next comment and change the line to:

tomcat.util.scan.StandardJarScanFilter.jarsToSkip=\*.jar

Instead of skipping the list of JAR’s at startup, Tomcat will skip all JAR’s.

Find the line:

tomcat.util.scan.StandardJarScanFilter.jarsToScan=log4j-core*.jar,log4j-taglib*.jar

Add a remark in front of the line:

#tomcat.util.scan.StandardJarScanFilter.jarsToScan=log4j-core*.jar,log4j-taglib*.jar

Update

An minor update requires mostly only the replacement of the files in the folders C:\Program Files\Tomcat\bin and C:\Program Files\Tomcat\lib. Stop the Tomcat service, replace the files and start the service. That’s it.

Reference: Tomcat Configuration Reference