Activate your Commerce Intelligence Account for On-Premise and Starter Subscriptions

To activate Commerce Intelligence for on-premise subscriptions, first create a Commerce Intelligence account, enter your settings information, then connect Commerce Intelligence to your Commerce database.

Create your Commerce Intelligence account

To create your account, contact your Adobe Account Team or Customer Technical Advisor.

Create your password

After your account has been created, check your email for an account notification email from The Magento BI Use the link provided in the email to access your Commerce Intelligence account and create your password. Go to your inbox and verify your email address.

If you did not receive an email, contact support.

Set your store preferences

Before you configure the database connection, complete the store information form. This information is required to complete the Connect your Database setup.

Add Commerce Intelligence users

After you set your password and log into Commerce Intelligence, you can add other users to your Commerce Intelligence account. When adding users, add admin users with appropriate permissions to complete the activation process.

Create a dedicated Commerce Intelligence user in the Commerce admin

To use Commerce Intelligence, you must add a permanent and dedicated user to the Commerce project. This dedicated user serves as a permanent connection to Commerce that enables the fetch and transfer of new data to the account’s Commerce Intelligence Data Warehouse.

Configuring a dedicated Commerce Intelligence user ensures that the account is not deactivated or deleted, thus stopping the Commerce Intelligence connection.

Adobe encourages using an account name that indicate its permanent status (e.g., ACI-dedicated, ACI-database-connector, and so forth).

After you created the dedicated user for Commerce Intelligence in the Admin, add the same user to the primary environment of the Commerce project with a Master setting of Contributor.

Get your Commerce Intelligence SSH keys

  1. On the Connect your database page for Commerce Intelligence setup, scroll down and select Encryption settings.

  2. For Encryption Type, select SSH Tunnel.

  3. From the drop-down, copy the public key that is provided.

Add your public key to the Commerce Intelligence

  1. From the Commerce Admin, sign in using the login information for the Commerce Intelligence user you just created.

  2. Select the Account Settings tab.

  3. Scroll down and expand the SSH Keys drop-down. Then, select Add a public key.

  4. Paste the public key that you copied in the Encryption Type step above.

Provide Commerce Intelligence Essentials MySQL credentials

  1. Update your .magento/services.yaml.

  2. Update your

Get database connection information

Get the database connection information to the Commerce database to Commerce Intelligence

  1. Run the following to get your information.

    echo $MAGENTO_CLOUD_RELATIONSHIPS | base64 --decode | json_pp

  2. Review the database information, which should look similar to the following example.

Connect Commerce Intelligence to your Commerce database using an encrypted connection

Adobe strongly recommends that you use an SSH tunnel tunnel to make the database connection. However, if this method is not an option, you can still link Commerce Intelligence to your database using a direct connection.

Enter your Commerce Intelligence information in the Connect your Magento Database screen.


Integration Name: [choose a name for your Commerce Intelligence instance]

Host: mbi.internal

Port: 3306

Username: mbi

Password: [input password displayed in the previous section]

Database Name: main

Table Prefixes: [leave blank if there are no table prefixes]

Set your Time Zone settings


Database Timezone: UTC

Desired Timezone: [choose the time zone for which you want your data to display]

Get your encryption settings information

The project UI provides an SSH access string. This string can be used for gathering the information needed for the Remote Address and Username. Use the SSH Access string by selecting the access site button on the Master branch of the Project UI. Then, find your User Name and Remote Address as shown below.

Input your Encryption settings


Encryption Type: SSH Tunnel

Remote Address: [from the previous step]

Username: vfbfui4vmfez6-master-7rqtwti—mymagento [from the previous step]

Port: 22

Save your integration.

After completing the configuration steps, apply the changes by selecting Save Integration.

You have now successfully connected your Commerce database to your Commerce Intelligence account.

If you are a Adobe Commerce Intelligence Pro customer, contact your Customer Success Manager or Customer Technical Advisor to coordinate the next steps.

After you complete the configuration, sign in to your Commerce Intelligence account.