How to disable cluster mode in Confluence Data Center
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
To set up clustering in Confluence Data Center 7.2 or later, you need to enable cluster mode. When you do this, Confluence adds a cluster.setup.ready property to the confluence.cfg.xml file, and sets this value to ‘true’. This means your instance is ready for clustering, but you haven’t yet set up and configured the cluster.
If you want to undo this action, you can manually disable cluster mode by modifying the cluster.setup.ready property, as outlined below.
This guide does not apply to Confluence Data Center sites running in a cluster. It is specific for situations where clustering was enabled but not configured yet, since those are two separate stages.
If you’ve already set up clustering, the solution below does not apply. If you want to move back to a non-clustered installation, see Move to a non-clustered installation.
Solution
To disable cluster mode:
Edit
<Confluence home>/confluence.cfg.xmlFind the
cluster.setup.readyproperty.Change the property value to
false:Before:
1<property name="cluster.setup.ready">true</property>After:
1<property name="cluster.setup.ready">false</property>Save the file.
To confirm your site is no longer in cluster mode, go back to the Clustering screen (⚙ > General configuration > Clustering), and refresh the page. You should see the Enable cluster mode button.
Was this helpful?