Database Configuration

This document provides information on connecting Confluence to an external database.

Choosing an external database

Note: Take time to choose your database wisely. The XML backup built into Confluence is not suited for migration or backup of large data sets. If you need to migrate later, you'll need to use a third party database migration tool.

Below is more information on selecting and migrating to an external database:

About the embedded H2 database 

Your Confluence installation includes an embedded H2 database, to enable you to try Confluence without setting up an external database. The embedded H2 database is only supported while you are evaluating Confluence. You must migrate to a supported external database before using Confluence as a production system. 

To find out if you are still using the embedded database, go to  > General Configuration > Support Tools.

Database setup

Here are the setup instructions for the supported databases:

Database troubleshooting

For solving database-related problems:

Obtain technical support from Troubleshooting Problems and Requesting Technical Support.


Issue CONF-12599 requests a more robust strategy for migrating large Confluence sites.

Last modified on Dec 2, 2015

Was this helpful?

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