How to change Bamboo user session timeout

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

The default user session timeout in Bamboo is 30 minutes. This means every user will be logged out after 30 minutes of inactivity and will be prompted to log in again.

The purpose of this article is to show how to change the user session timeout.

Solution

  • Stop Bamboo server.

  • Go to the $BAMBOO_INSTALL/atlassian-bamboo/WEB-INF directory.

  • Open up the web.xml file and locate the following piece of code:

    1 2 3 <session-config> <session-timeout>30</session-timeout> </session-config>

    ℹ️ The session-timeout value is in minutes.

  • Adjust the session timeout according to your needs and save the file.

  • Start Bamboo server.

In Bamboo versions before 6.8.0, due to a bug a session would never time out if a user left their browser open while displaying a page in Bamboo.

Updated on April 2, 2025

Still need help?

The Atlassian Community is here for you.