Migrating Bold BI Docker Instance Deployed Using Docker Desktop

Migrating a Bold BI Docker instance from one Windows machine to another Windows machine involves several steps to ensure that all data and configurations are correctly transferred. Follow the steps below to successfully migrate your Bold BI Docker instance.

Prerequisites

• Two Windows machines with Docker Desktop installed.
• Machine 1: Pre-installed with Bold BI.

Steps for Migration

1. Deploy Bold BI on Machine 1

Ensure Bold BI is deployed on Machine 1 by following the Install Bold BI on Docker documentation. After successful deployment, create or import the necessary dashboards.

2. Backup Volume

To migrate the Bold BI application, you need to back up the Docker volume from Machine 1. Follow these steps:

1. Navigate to Volumes: Open Docker Desktop on Machine 1. Navigate to the volumes tab and click on your Boldbi_data volume.
   

   

2. Export Volume: Navigate to the Exports tab and click on quick exports. Then, in the local or hub tab, click on local file and browse to the location where you want to back up the file. Click on save. To back up the PostgreSQL volume, follow the same steps.
   

   
   

3. Transfer Backup Volume to Machine 2: Transfer the exported volume file to Machine 2.

3. Deploy Bold BI on Machine 2

Follow the Install Bold BI on Docker documentation to deploy Bold BI on Machine 2. Use the same file that you used on Machine 1 to deploy Bold BI.

4. Restore Volume

1. Before restoring, stop the container. Then proceed to restore the volumes.

2. To restore the Boldbi_data volume, navigate to the following location in File Explorer and replace the files in this directory with the files from your backup folder. Ensure that each file is correctly replaced:
   \\wsl.localhost\docker-desktop\mnt\docker-desktop-disk\data\docker\volumes\

   

3. Ensure that you have correctly restored or replaced the file as shown in the image below. Once verified, start the container.
   

   

4. To restore the PostgreSQL volume, follow the same steps.

Note: If you are planning to use a different APP_URL or a different DB server in Machine 2, you can follow the instructions in the Bold BI Migration Document to reset the connection string and application URL.

5. Verify the Migration

1. Start the Bold BI application on Machine 2.
2. Verify that all dashboards and data have been successfully migrated and are functioning as expected.

Additional References

1. Migrate Bold BI Application from Windows to Linux.
2. Migrate Bold BI Application from Window to Azure Kubernetes Service