Bitbucket Server fails to start - UnsupportedDirectoryOverrideException


アトラシアン コミュニティをご利用ください。



The following (or similar) appears in atlassian-bitbucket.log:

Caused by: com.atlassian.bitbucket.internal.home.UnsupportedDirectoryOverrideException: Overriding log directory location using bitbucket.home.log system property is no longer supported


Before Bitbucket Server 3.2 it was possible to use undocumented features to override the location of the following subfolders in bitbucket home:

  • export
  • bin
  • caches
  • config
  • data
  • lib
  • lib/native
  • log
  • plugins
  • tmp

To achieve this users had two options:

  • Introduce an environment variable in the form BITBUCKET_HOME_[OVERRIDE], e.g. for overriding log - BITBUCKET_HOME_LOG
  • Or introduce a system property in the form bitbucket.home.[override], e.g. for overriding log - bitbucket.home.log

In Bitbucket Server 3.2 and above the option to override the location of the subfolders in bitbucket home is greatly reduced and will only work on the following folder:

  • tmp

For all other folders Bitbucket Server will refuse to start with the symptoms described in the previous section.


To resolve the issue bitbucket admins need to move the changed folders back under bitbucket home. For instance if the location of bin folder was overridden using the environment variable BITBUCKET_HOME_BIN then:

  • Firstly, bin must be put back under BITBUCKET_HOME/bin and 
  • Secondly, the corresponding environment variable (BITBUCKET_HOME_BIN) must be undefined

The same applies if system properties have been used instead of environment variables.


最終更新日 2015 年 9 月 16 日


Powered by Confluence and Scroll Viewport.