This documentation is for WSO2 Message Broker 3.0.0. View documentation for the latest release.
Due to a known issue do not use JDK1.8.0_151 with WSO2 products. Use JDK 1.8.0_144 until JDK 1.8.0_162-ea is released.
Skip to end of metadata
Go to start of metadata

The databases that are used for WSO2 Message Broker (MB) are stored in the <MB_HOME>/repository/database directory. By default, WSO2 MB is shipped with two embedded H2 databases as described in the table given below.


This is the Carbon database, which is used by default for storing Registry and User Management data.

In addition to the above databases, if the product uses features of WSO2 Identity Server or WSO2 Enterprise Store (ES), data which are specific to these features will also reside in the embedded Carbon database by default. However, for production environments, we recommend you to use separate RDBMS databases to store identity-related and storage-related data. is a product-specific database, which is used for storing data relevant to MB.

These embedded H2 databases are suitable for development, testing, and some production environments. For most production environments, however, we recommend to use industry-standard RDBMSs such as Oracle, MySQL, MS SQL, etc. 

The following topics explain how you can replace the default databases explained above with industry-standard DBMSs:

  • No labels