"Exception bootstrapping cluster:Shared home directory is not configured correctly" Error during Confluence Data Center startup

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

This article applies to Confluence Data Center 5.6 or later.

Symptoms

Confluence Data Center fails to startup, with the following error in the console:

1 2 3 4 2014-08-06 21:10:42,588 ERROR [localhost-startStop-1] [atlassian.config.bootstrap.DefaultAtlassianBootstrapManager] init Home  is not configured properly: com.atlassian.config.ConfigurationException: Exception bootstrapping cluster:Shared home directory  is not configured correctly: location=C:\reproduce\confluence-standalone-cluster-distribution-5.6-m8-cluster\sharefresh,  exists=false, isDirectory=false, canRead=false

Cause

Confluence is unable to read/write into the shared home directory, that is defined in the node's ConfluenceHome/confluence.cfg.xml. Example:

1 <property name="confluence.cluster.home">/home/foo/sharehome</property>

Resolution

  • Identify the path to the shared home directory, as per defined in the node's ConfluenceHome/confluence.cfg.xml, in the confluence.cluster.home parameter as per the one shown above

  • Make sure that the node is able to read/write to that directory, and that the directory exists (either modify the filesystem permission, or create the directory manually)

Updated on April 11, 2025

Still need help?

The Atlassian Community is here for you.