How to Upgrade The Tomcat Container for Confluence

Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.

Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Except Fisheye and Crucible

Summary

Please note that these changes are not supported and this article is provided for informational purposes only. EAR/WAR support was depreciated in Confluence 5.7. The only supported application server is the version of Tomcat that is bundled with each release.

Due to security concerns or company policy, the Tomcat container housing Confluence needs to be upgraded. This guide explains how to upgrade Tomcat.

Solution

Resolution

Make a Backup of the <confluence install directory> before proceeding

  1. Shutdown Confluence

  2. Download a compatible version of Tomcat and unzip it

  3. Copy the contents of the bin folder to your <install-directory>/bin folder, replacing existing files

  4. Copy the contents of the lib folder to your <install-directory>/lib folder, replacing existing files

  5. Start Confluence

Updated on April 2, 2025

Still need help?

The Atlassian Community is here for you.