Bitbucket Server fails to start - UnsupportedDirectoryOverrideException
The following (or similar) appears in
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:
To achieve this users had two options:
- Introduce an environment variable in the form
BITBUCKET_HOME_[OVERRIDE], e.g. for overriding log -
- Or introduce a system property in the form
bitbucket.home.[override], e.g. for overriding 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:
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
binmust be put back under
- Secondly, the corresponding environment variable (
BITBUCKET_HOME_BIN)must be undefined
The same applies if system properties have been used instead of environment variables.