This documentation is for WSO2 Identity Server 5.0.0. View documentation for the latest release.
Page Comparison - Working with Databases (v.6 vs v.7) - Identity Server 5.0.0 - WSO2 Documentation

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.

The default database in WSO2 products is an embedded H2 database, which stores user data and data related to WSO2 Carbon, the platform on which WSO2 products are built. However, you The default databases that WSO2 products uses to store registry, user manager and product-specific data are the H2 databases in <PRODUCT_Home>/repository/database as follows:

  • WSO2CARBON_DB.h2.db: used to store registry and user manager data

These embedded H2 databases are suitable for development, testing, and some production environments. For most production environments, however, we recommend you to use an industry-standard RDBMS such as Oracle, PostgreSQL, MySQL, MS SQL, etc. In addition to the above databases, data that is specific to the WSO2 Identity Server resides in the embedded Carbon database. However, for production environments, we recommend you to use separate RDBMS databases to store identity-related and storage-related data.

You can use the scripts provided with WSO2 products to install and configure several other types of relational databases, including MySQL, IBM DB2, Oracle, and more. These scripts are located in the <PRODUCT_HOME>/dbscripts/ folder.


 The following section explains how to change the default databases:

Children Display