Migrating Confluence 5.1.3 to 5.6.1 from one server to another.


We have Confluence 5.1.3 on one server (Windows) and 5.6.1 on another server (Linux).  

I know I will need to backup DB and home directory.  When restoring them to 5.6.1 will the DB be upgraded automatically?  Also, will things like macros and plugins work, or do I need to do something specific. 

Thank you.

2 answers

1 accepted

1 vote
Accepted answer

Hi Ahmad, 


Before jumping to the standard procedures from an upgrade, we suggest the users to check the plugin compatibility with the next versions to avoid further issues. 

You don't have to worry about your database, with a full XML backup (please add the attaches in this backup), Confluence will do the magic, I mean, populate the new database, make everything right. So, you don't need to do a clone of your database.

In this link you can find more details related to Confluence migration.

I hope it helps.



Renato Rudnicki

Thank you Renato for your response. That definetly helps. Do you think there will be issues since we are moving from Windows to Linux since Linux is case sensitive. Not sure if it will break anything like certain attachments, etc... Anything you see that we should be aware of? Thank you again.

i dont think there will be an issue migrating from windows to linux. the paths in the basic configs are different, but the application itself runs within a jvm and as such the operating system isnt that critical. I have migrated also quite some systems, to get more confidence i suggest you try it in a test/sandbox environment first ;)

Thanks Frank! We will for sure be testing this. I just wanted to see if I can catch the issue ahead. Going back to what Renato stated about the DB. My understanding of doing a full XML backup is not recommended if the DB is large. I think ours is just under 20 GB. I think there is a migration utility if we are just going to upgrade the DB directly.

1 vote

Hi Ahmad, 

I'm glad that I could help you smile.

If you have a large DB, you are right about maybe a full XML backup might not be the best option. In this case, you can increase the JAVA memory from your Confluence, or try to migrate your Database using a dump database. 

Ahmad, if this issue is answered, do you mind to mark it as "Answered"? I'm saying that because it might helps other people who are having a similar question.

However, if you still have any questions, please feel free to post it here. We'll be glad to help you smile.


Best regards, 

Renato Rudnicki

Suggest an answer

Log in or Sign up to answer
Community showcase
Posted Feb 06, 2019 in Confluence

Try out the new editing experience

Hi team, I’m Avinoam, a product manager on Confluence Cloud, and today I’m really excited to let the Community know that all customers can now try out the new editing experience and see some of the ...

782 views 33 5
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