How to deploy with an existing database

The provisioning part of BCD is now deprecated and will be removed ! We do not recommend using it.

By default, BCD provisions a database Docker container while deploying your Bonita stack.
Alternatively, BCD also lets you connect your Bonita stack with an existing database server. The database vendor and version has to be supported by BCD though.

When the bonita_db_host variable is defined, BCD does not create a database container. Instead, BCD expects to connect to an existing database.
The following variables are to be set accordingly:

  • bonita_db_vendor - Vendor name in [postgres, mysql, oracle].

  • bonita_db_host - Host name or IP address (eg.

  • bonita_db_port - Port number (eg. 5432).

  • bonita_db_admin_user - Name of an existing Administrator user (aka. "Master username"). This user must be granted permissions to create the Bonita and Business Data Model (BDM) databases.

  • bonita_db_admin_pass - Password of the Administrator user.

Example with Amazon RDS

One typical use case is to deploy your Bonita stack using an Amazon RDS instance.

  1. Prior to creating your RDS instance, create and customize a DB Parameter Group in order to set database parameters for Bonita. Refer to Bonita documentation to check how to Customize RDBMS to make it work with Bonita.

  2. Create your RDS instance using the DB parameter group created previously. Make sure the assigned security group allows access to the DB instance.
    Leave the Database Name field empty to not create a database. BCD will create required databases automatically.

  3. Report connection information into your BCD scenario:

    • bonita_db_host - DB instance endpoint (eg.

    • bonita_db_port - Database Port (eg. 5432).

    • bonita_db_admin_user - Master Username.

    • bonita_db_admin_pass - Master Password.