How to Generate a New confluence.cfg.xml
If Confluence is started and takes you to the Setup Wizard, as if you were installing it for the first time, that means something has happened to prevent Confluence from finding its home directory, which is defined in <confluence_install_directory>/confluence/WEB-INF/classes/confluence-init.properties.
If the <confluence_home_directory/confluence.cfg.xml file is missing or damaged, here is a way to generate a new, valid one.
Step-by-Step Guide
Back up your production database and Confluence home directory.
- Create a new, blank database. This is solely for creating the new
confluence.cfg.xmlfile and will be discarded later. - Create a temporary home directory. This is solely for creating the new
confluence.cfg.xmlfile and will be discarded later. Edit
<confluence_install_directory>/confluence/WEB-INF/classes/confluence-init.propertiesby changing it to point to the temporary home directory you created in Step 3.Start Confluence.
Go through the Setup Wizard. On the database configuration screen, point Confluence to the database you created in Step 2.
Complete the Setup Wizard.
Once the installation is complete, shut down Confluence.
At this point you should have a brand new Confluence installation with a temporary home directory containing a new (and complete)
confluence.cfg.xmlfile.Copy that file to your actual home directory (the one you backed up in Step1). Delete the old
confluence.cfg.xmlfile if it exists.Modify the new
confluence.cfg.xmlfile by changing the database connection string so that it's pointing to your production DB.Modify
<confluence_install_directory>/confluence/WEB-INF/classes/confluence-init.propertiesagain by pointing it back to your existing Confluence home.Start Confluence.