How to copy plugins/add-ons when migrating Confluence between servers?

We are currently in the process of migrating several Confluence instances between servers. Confluence versions range from 3.5.x to 4.x. I am familiar with your nice migration documentation based on which we are using the XML backup method. We have chosen this method because we'll be migrating to a different OS and database. Otherwise we would like to keep the installation as close to the original as possible (same Confluence and plugin/add-on versions).

With the above description in mind, what would be the best way to copy plugins/add-ons from the original Confluence server to the new one? To specify a bit, I'm talking about user installed plugins.

Here's what I know so far and some more detailed questions:

  • User installed plugins/add-ons can be listed in administration console and then the specific version can be downloaded via Marketplace.
  • [Confluence home]/plugins-cache folder seems to contain the JAR files of user installed plugins. Can these JARs be used to install plugins in the new Confluence instance via administration console?
  • If it is possible to use JARs in [Confluence home]/plugins-cache, is there an easier way to install than one-by-one though admin console?

1 answer

1 accepted

Hi Joni.

I am afraid plugins are not stored in XML backups. As they are stored in the database, you can try to migrate your database using native database tools. Only when copying the whole database, plugins will be copyed. If you have to use an XML backup you will need to reinstall the plugins manually.

In my experience, this is true. One caveat: sometimes the settings on the plugins are not backed up. At least, that's what happened with the HTML plugin when I did a database dump and restore. I had to reconfigure it (re-enable certain modules that were enabled on the origin server).

Alex: I was a bit afraid that your #1 suggestion would be "use a database migration tool". :) We were hoping we could avoid that. On the other hand, manual installation is also quite time-consuming and also error prone.

Matthew: Good input! Have to keep that in mind if we choose the database migration path.

Thank you both!

Suggest an answer

Log in or Sign up to answer
How to earn badges on the Atlassian Community

How to earn badges on the Atlassian Community

Badges are a great way to show off community activity, whether you’re a newbie or a Champion.

Learn more
Community showcase
Posted Monday in Confluence

Calling all marketing teams who use Confluence - we want to hear from you!

Hi Community! me again 🙂 If you’re a marketing team using Confluence, we want to hear your story! How did you start using Confluence? What are your use cases? What have been some of the benefits?...

208 views 3 3
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