How to Upgrade The Tomcat Container for Confluence
Platform Notice: Data Center Only - This article only applies to Atlassian apps 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
Unsupported procedure. Swapping the bundled Tomcat is not supported by Atlassian and this article is provided for informational purposes only. The only supported application server is the version of Tomcat bundled with each Confluence release. Only proceed if a security or company-policy requirement forces it, and expect to revert if you hit issues. EAR/WAR support was depreciated in Confluence 5.7.
Only use a Tomcat version compatible with your Confluence release. Check the Bundled Tomcat and Java versions page to identify which Tomcat version is bundled with your Confluence version before downloading a replacement.
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
Shutdown Confluence
Download a compatible version of Tomcat and unzip it
Copy the contents of the bin folder to your
<install-directory>/binfolder, replacing existing filesCopy the contents of the lib folder to your
<install-directory>/libfolder, replacing existing filesStart Confluence
After starting, confirm a clean boot: check <install-directory>/logs/catalina.out for the Tomcat version line and <confluence-home>/logs/atlassian-confluence.log for Confluence is ready to serve, then load the site and verify version under Administration (⚙) > General Configuration > System Information.
Related articles
Was this helpful?