How do I change the default session timeout

Still need help?

The Atlassian Community is here for you.

Ask the community

Bitbucket Server 5.0

Starting with Bitbucket Server 5.0+, the configuration in web.xml is no longer used and all changes are read from

Setting server.session.timeout=1800 in will adjust the default session timeout. This value is set in seconds. See Configuration properties for more information.

For Bitbucket versions below 5.0, the default (30 minutes) session timeout can be changed by editing the file web.xml. This file can be found in <Bitbucket Server installation directory/conf/web.xml.

The element you want to edit in the web.xml file is:

<web-app ...>
  <!-- ==================== Default Session Configuration ================= -->
  <!-- You can set the default session timeout (in minutes) for all newly   -->
  <!-- created sessions by modifying the value below.                       -->


The value within the session-timeout tag defines the amount of time the session will exist, in minutes.

To set Bitbucket's session cookies to also expire when the browser closes, it's recommended to set server.session.cookie.max-age=-1 in your file.

Note that after making these changes, you will need to restart Bitbucket Server.

Last modified on Dec 16, 2022

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.