How to run CubeBackup for Google Workspace 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, 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 Volumes section, create four pairs of directories. We have example directories for the Host Paths, but these can be changed depending on your particular needs. The Container Paths, however, must be created exactly as listed here:
  4. Host Path Container Path
    /Users/a/cube/db /opt/cubebackup/db storage configuration directory
    /Users/a/cube/log /opt/cubebackup/log CubeBackup log directory
    /Users/a/cube/etc /opt/cubebackup/etc CubeBackup configuration directory
    /Users/a/backupData /cubebackup_data backup storage directory
    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.
  5. Before clicking Run, upload this config.toml file into the /Users/a/cube/etc directory.
  6. Click Run and switch to Containers in the left panel. You should now see the CubeBackup container listed.
  7. Click ⋮ under Actions and select Open with browser to open the initial setup wizard.
  8. open the configuration page
  9. Please follow the step-by-step instructions to configure CubeBackup.
  10. To open the CubeBackup web console in the future, you can either click the same link 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, 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. 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.
  4. 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.
  5. mount volume on Mac
  6. Open the Terminal on your Mac and run the following command to confirm that the volume is successfully mounted.
    ls -al /Volumes/
  7. list volume on Mac
  8. If your NAS is displayed in the /Volumes directory, you can return to Docker Desktop. In the Volumes section, create four pairs of directories. We have example directories for the Host Paths, but these can be changed depending on your particular needs. The Container Paths, however, must be created exactly as listed here:
  9. Host Path Container Path
    /Users/a/cube/db /opt/cubebackup/db storage configuration directory
    /Users/a/cube/log /opt/cubebackup/log CubeBackup log directory
    /Users/a/cube/etc /opt/cubebackup/etc CubeBackup configuration directory
    /Volumes/backupData /cubebackup_data backup storage directory
    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.
  10. Before clicking Run, upload this config.toml file into the /Users/a/cube/etc directory.
  11. Click Run and switch to Containers in the left panel. You should now see the CubeBackup container listed.
  12. Click ⋮ under Actions and select Open with browser to open the initial setup wizard.
  13. open the configuration page
  14. Please follow the step-by-step instructions to configure CubeBackup.
  15. To open the CubeBackup web console in the future, you can either click the same link 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, 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 Volumes section, create three pairs of directories. We have example directories for the Host Paths, but these can be changed depending on your particular needs. The Container Paths, however, must be created exactly as listed here:
  4. Host Path Container Path
    /Users/a/cube/db /opt/cubebackup/db storage configuration directory
    /Users/a/cube/log /opt/cubebackup/log CubeBackup log directory
    /Users/a/cube/etc /opt/cubebackup/etc CubeBackup configuration directory
  5. Before clicking Run, upload this config.toml file into the /Users/a/cube/etc directory.
  6. Click Run and switch to Containers in the left panel. You should now see the CubeBackup container listed.
  7. Click ⋮ under Actions and select Open with browser to open the initial setup wizard.
  8. open the configuration page
  9. Please follow the step-by-step instructions to configure CubeBackup.
  10. To open the CubeBackup web console in the future, you can either click the same link 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/a/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 Open in terminal link. 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.