How to run CubeBackup on a Mac.


CubeBackup is designed to run on Windows and Linux systems. If you want to run CubeBackup on a Mac machine, you can:

  • Run CubeBackup on a VM on your Mac.
  • Run CubeBackup in a docker container on your Mac.

Installation Instructions

Experienced Docker users can easily pull the CubeBackup image cubebackup/cubebackup to a local repository, start the CubeBackup container, and follow the step-by-step setup guide to complete the initial configuration.

For users who are not familiar with Docker, Docker Desktop offers an easy-to-install solution to run CubeBackup on a Mac. Please follow the instructions below to create a containerized CubeBackup instance to backup your Google Workspace data:

  1. Download the Docker Desktop for Mac installation package.
  2. Double click the .DMG file and follow the prompts to install it on your computer.
  3. Open the application and wait for the docker engine to start.
  4. Next you will need to pull the CubeBackup image to your local repository. Open a command-line Terminal window, and run the following command:

    docker pull cubebackup/cubebackup

    docker pull cubebackup/cubebackup

  5. Open the Docker Desktop and select Images from the left panel to verify that the cubebackup/cubebackup image has been successfully added. Hover over the entry and Click RUN.

    docker run image

  6. Click Optional Settings in the prompt window to display the advanced settings. Backing up to on-premises or cloud storage should use different settings. Please click the corresponding tab below to configure your container.

    docker optional settings

    docker configuration for local storage
  1. Enter a Container name (e.g. CubeBackup).
  2. In the Ports section, click ⊕ at the right end, and enter 80 in the textbox in front of the corresponding Container Port 80/tcp. If the port is already in use, you can select another one (e.g. 8080) for the CubeBackup web console.
  3. In the Host Path of the Volumes section, select or create a directory on the local drive of your Mac (e.g./Users/abc/cube/db) to store the CubeBackup storage configuration files. Enter /opt/cubebackup/db/ in the corresponding Container Path.
  4. Repeat the operation and select a directory on your Mac to store the CubeBackup log files (e.g. /Users/abc/cube/log). Enter /opt/cubebackup/log in the corresponding Container Path.
  5. You will need to create a local directory for the backup data first (e.g. /Users/abc/backup-data) and select it in the Host Path. Enter /cubebackup_data in the Container Path.
  6. NOTE:
    The CubeBackup container can now access the backup storage location directly using /cubebackup_data. Later, when you run the CubeBackup setup wizard, please ensure that the Backup path points to /cubebackup_data.
  7. You can leave the other options as default and click Run.
  8. Switch to Containers / Apps in the left panel, and you should now see the CubeBackup container listed. Click the first OPEN IN BROWSER icon to start the configuration wizard.
  9. open the configuration page
  10. Please follow the step-by-step instructions to configure CubeBackup.
  11. To open the CubeBackup web console in the future, you can either click the same OPEN IN BROWSER icon in Docker Desktop, or visit http://127.0.0.1 directly in a web browser. If you changed port 80 to a different port in Step 8, please add the port number to the end of the URL (e.g. http://127.0.0.1:8080).
    docker configuration for mounted network storage
  1. Enter a Container name (e.g. CubeBackup).
  2. In the Ports section, click ⊕ at the right end, and enter 80 in the textbox in front of the corresponding Container Port 80/tcp. If the port is already in use, you can select another one (e.g. 8080) for the CubeBackup web console.
  3. In the Host Path of the Volumes section, select or create a directory on the local drive of your Mac (e.g. /Users/abc/cube/db) to store the CubeBackup storage configuration files. Enter /opt/cubebackup/db/ in the corresponding Container Path.
  4. Repeat the operation and select a directory on your Mac to store the CubeBackup log files (e.g. /Users/abc/cube/log). Enter /opt/cubebackup/log in the corresponding Container Path.
  5. Your NAS drive or other network storage must be mounted before continuing. Open the System Preferences -> Users & Groups on your Mac, then click the Login Items tab at the top-right.
  6. Then click + at the bottom and follow the prompts to add the backup volume. Click the lock to make changes. For example, you can add a new directory backupData on the NAS to the login items.
  7. mount volume on Mac
  8. Open the Terminal on your Mac and run the following command to confirm that the volume is successfully mounted.
    ls -al /Volumes/
  9. list volume on Mac
  10. If your NAS is displayed in the /Volumes directory, you can return to Docker Desktop and choose a subfolder within your NAS as the Host Path(e.g. /Volumes/backupData)Then enter /cubebackupData in the Container Path.
  11. NOTE:
    The CubeBackup container can now access the backup storage location directly using /cubebackup_data. Later, when you run the CubeBackup setup wizard, please ensure that the Backup path points to /cubebackup_data.
  12. You can leave the other options as default and click Run.
  13. Switch to Containers / Apps in the left panel, and you should now see the CubeBackup container listed. Click the first OPEN IN BROWSER icon to start the configuration wizard.
  14. open the configuration page
  15. Please follow the step-by-step instructions to configure CubeBackup.
  16. To open the CubeBackup web console in the future, you can either click the same OPEN IN BROWSER icon in Docker Desktop, or visit http://127.0.0.1 directly in a web browser. If you changed port 80 to a different port in Step 8, please add the port number to the end of the URL (e.g. http://127.0.0.1:8080).
    docker configuration for cloud storage
  1. Enter a Container name (e.g. CubeBackup).
  2. In the Ports section, click ⊕ at the right end, and enter 80 in the textbox in front of the corresponding Container Port 80/tcp. If the port is already in use, you can select another one (e.g. 8080) for the CubeBackup web console.
  3. In the Host Path of the Volumes section, select or create a directory on the local drive of your Mac (e.g. /Users/abc/cube/db) to store the CubeBackup storage configuration files. Enter /opt/cubebackup/db/ in the corresponding Container Path.
  4. Repeat the operation and select a directory on your Mac to store the CubeBackup log files (e.g. /Users/abc/cube/log). Enter /opt/cubebackup/log in the corresponding Container Path.
  5. You can leave the other options as default and click Run.
  6. Switch to Containers / Apps in the left panel, and you should now see the CubeBackup container listed. Click the first OPEN IN BROWSER icon to start the configuration wizard.
  7. open the configuration page
  8. Please follow the step-by-step instructions to configure CubeBackup.
  9. To open the CubeBackup web console in the future, you can either click the same OPEN IN BROWSER icon in Docker Desktop, or visit http://127.0.0.1 directly in a web browser. If you changed port 80 to a different port in Step 8, please add the port number to the end of the URL (e.g. http://127.0.0.1:8080).

Manage you CubeBackup container using Docker Desktop

  1. We strongly recommend that you make a copy of the encryption key file and store it in a separate safe location. You can either find it at /opt/cubebackup/db/keys.json inside the docker container or from the mounted volume on the Mac (e.g. /Users/abc/cube/db/keys.json).

    Please note that if the key file is lost, your encrypted backup data will be completely unrecoverable. CubeBackup Inc. does not have access to any key files and will be unable to help you!

  2. The installation directory of CubeBackup can be accessed directly in the docker container using CLI, which you can open by clicking the second icon. open docker CLI

  3. CubeBackup is designed to run continuously on a backup server. Please try not to interrupt the network connection especially during the initial backup, which may take several days to complete.

  4. If it’s impossible to keep the network connection alive or if the computer is shut down frequently, please consider restricting the backup tasks to appropriate hours to avoid forced quitting and other unexpected errors by using CubeBackup’s throttling options.