Limitations of Bamboo Data Center: Unsupported High Availability and Clustering Database
Platform Notice: Data Center - This article applies to Atlassian products on the Data Center platform.
Note that this knowledge base article was created for the Data Center version of the product. Data Center knowledge base articles for non-Data Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.
*Except Fisheye and Crucible
Summary
Atlassian Bamboo Data Center does not support High Availability (HA) or clustering database setups. This article provides details on this limitation and recommendations for optimal database configurations for Bamboo.
Bamboo Data Center is designed to operate with a single-instance database. Configuring Bamboo to use databases in HA or clustering modes (e.g., active-active or active-passive configurations, clustering mechanisms like Galera Cluster, or similar setups) is not supported due to the following reasons:
Database Locking and Integrity
Bamboo relies on database-level locking mechanisms for critical operations. Clustering or HA setups can interfere with these locks, potentially leading to data corruption or performance degradation.Unsupported Behavior
Atlassian has not tested or certified Bamboo for use with databases configured for HA or clustering. Therefore, running Bamboo in such an environment could result in unpredictable behavior.Recommendations from Atlassian
Atlassian explicitly recommends using a single-instance database for Bamboo to ensure reliability, consistency, and supportability.
Solution
Running Bamboo with a clustered or HA database configuration is considered unsupported. If issues arise, Atlassian Support may request the use of a single-instance database as part of troubleshooting.
For optimal performance and supportability:
Use a single-instance database instance.
- Supported database types include PostgreSQL, MySQL, Microsoft SQL Server, and Oracle (per the Bamboo Supported Platforms).
Implement robust database backups and recovery procedures instead of clustering.
If database uptime is a critical concern, consider:
- Using a reliable database hosting solution with high uptime SLAs.
- Configuring read replicas for reporting purposes only (not for Bamboo's transactional operations).
Regularly monitor and maintain your Bamboo database for optimal health and performance.