Could not save access.mode into the shared confluence.cfg.xml file error after upgrading to Confluence Data Center 6.10

Still need help?

The Atlassian Community is here for you.

Ask the community

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


When upgrading Confluence Data Center to 6.10 or later, the following error appears in the application log:

ERROR [localhost-startStop-1] [atlassian.confluence.cluster.DefaultClusterConfigurationHelper] lambda$saveSharedProperty$3 Could not save access.mode into the shared confluence.cfg.xml file: {}
com.atlassian.config.ConfigurationException: failed to find config at: shared-home/confluence.cfg.xml
Caused by: shared-home/confluence.cfg.xml (No such file or directory)


Read-only mode, introduced in Confluence 6.10, writes the access mode (whether the site is currently read only or read / write) to the confluence.cfg.xml file located in the shared home directory. 

If you installed Confluence Data Center prior to Confluence 6.1, this file will not be present in your shared home directory, as it was only created for new installs, not when you upgraded to Confluence 6.1 or later. 


The simplest way to resolve this issue is to create the confluence.cfg.xml file in your shared home directory:

  1. Copy the confluence.cfg.xml file from the local home directory on one of your Confluence nodes to your shared home directory. 
  2. Edit the file, and remove all properties,  except for the following:

        <property name="access.mode"> ... </property>
        <property name="atlassian.license.message"> ... </property>
        <property name="confluence.cluster">true</property>
        <property name="hibernate.setup">true</property>
        <property name="jwt.private.key"> ... </property>
        <property name="jwt.public.key"> ... </property>
        <property name="lucene.index.dir">${localHome}\index</property>

    Make sure you include the real values for each parameter and property, for example the build number, and your private and public key. We've omitted the license and keys here to make this example easier to read. 

  3. Save the file, then start Confluence.

Last modified on Aug 8, 2018

Was this helpful?

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