Rename Confluence installation folder

Just upgraded Confluence 3.5.17 to 4.2.4 using the Windows installer. When the installer asked where Confluence was currently installed I pointed it towards this folder:


During the install I assumed it would rename this folder but it did not. I stopped the Cofluence service, unistalled the service, renamed the folder, reinstalled the service, and attempted to start the service. I received an error message about not finding CATALINA_HOME.

How can I rename the confluence install folder?

4 answers

1 accepted

Hello there,

I know that the installer is the easiest way, to perform an upgrade, however that sometimes doesn't happen, and could be painful for us.

I would like to suggest an alternative solution, which consists into install the standalone version and then follow the steps above to achieve the upgrade:

# Go to and download Confluence 4.2.4 ( the standalone version ).
# Extract the zip/tar.gz file of the latest version of Confluence on the place you choose. ( I highly suggest that you create a folder call: Confluence 4.3, and inside of this folder extract the install folder
# Into the extracted folder, open the file, which is located at Confluence install directory\confluence\web-inf\classes and edit the line: confluence.home=/usr/local/confluence/home to point to the path where is your old home folder (from 3.5.17) of your Confluence.
# Now start Confluence from the start-confluence.bat file, which should be located in the bin folder.

I hope this helps.



I suspect this is because the Windows Service was still pointing to the old installation path. After renaming, you will have to remove the existing Windows Service and re-create it. This can be done with the <confluence-install>/bin/service.bat file.

See more details here on running Confluence as a Windows Service and how to remove/install the service manually:





I did use the service.bat file to uninstall the service

Then I renamed the install folder

I then used the service.bat file to reinstall the service

When I went to start the service I got an error message about not being able to find CATALINA_HOME

I finally got this to work:

1. Stopped the service

2. Uninstalled the service using the service.bat file

3. Rename Confluence-3.5.17-std to Confluence

4. Went into the registry and found a few spots that referred to the current direct name (Confluence-3.5.17-std) and changed these to confluence

5. Edited the service.bat file where there was also a few spots that referred to the old directory name that I change to the new directory name

6. Reinstalled the service using the service.bat file

7. Started the service and it worked fine

The answer is shown in my previous post

Suggest an answer

Log in or Join to answer
Community showcase
Maarten Cautreels
Posted Thursday in Off-topic

Friday Fun: What's your favourite beer/drink

As a Belgian, beer-lover and home brewer, beer is one of my great passions. I love the fact that with just a few ingredients (usually just water, hop and malt) you can create so many different tastes...

281 views 38 9
Join discussion

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you
Atlassian Team Tour

Join us on the Team Tour

We're bringing product updates and pro tips on teamwork to ten cities around the world.

Save your spot