CubeBackup for Microsoft 365 Configuration Guide: storage.json

What is the purpose of the storage.json file?

The storage.json file is the configuration file for your backup storage. Starting from version 1.1, this file will be automatically encrypted in CubeBackup for Microsoft 365. For installations upgraded through the console, or versions prior to 1.1, the following fields are still displayed in the storage.json.

In certain cases, you may need to update your storage credentials or change the backup location by modifying this file in a text editor.

The storage.json file is located in the <CubeBackup installation directory>/data folder.

On Windows, the file is stored in the "C:\Program Files\CubeBackup365\data\" directory by default.
On Linux, the file is stored in the "/opt/cubebackup365/data" directory by default.

Fields in the storage.json file

Fields in storage.json file vary with different storage types. For a detailed sample and explanation, please click the appropriate tab below for your storage type and operating system.

storage.json sample

{
  "EncryptEnabled": true,
  "Type": "LOCAL",
  "IndexPath": "/opt/cubebackup365/index",
  "DataPath": "/var/cubebackup_data"
}

storage.json Field Definitions

EncryptEnabled: Whether or not the backup data should be encrypted.

true: Encrypt the backup data.
false: Do not encrypt the backup data.
Type: The storage type.

"LOCAL": Local disk
IndexPath: The storage location for the data index.

The data index should be stored on a local disk (local SSD is strongly recommended).
DataPath: The location for the backup data.

On Windows, double backslashes should be used to separate the directories in the path.
For example:

  "IndexPath": "C:\\Program Files\\CubeBackup365\\index"
  "DataPath": "D:\\backups\\gsuite_data"

storage.json sample

{
  "EncryptEnabled": true,
  "Type": "WINS",
  "IndexPath": "C:\\Program Files\\CubeBackup365\\index"
  "WinsLocation": "\\\\BACKUPNAS\\homes\\gsuitebackups"
  "WinsUsername": "BACKUPNAS\\cube",
  "WinsPassword": "12345"
}

storage.json Field Definitions

EncryptEnabled: Whether or not the backup data should be encrypted.

true: Encrypt the backup data.
false: Do not encrypt the backup data.
Type: The storage type.

"WINS": Windows network location
IndexPath: The storage location for the data index.

The data index should be stored on a local disk (local SSD is strongly recommended).
WinsLocation: The network storage path on Windows.
WinsUsername & WinsPassword: The username and password to access the network location on Windows.

On Windows, double backslashes should be used to separate the directories in the path.
For example:

  "IndexPath": "C:\\Program Files\\CubeBackup365\\index"
  "WinsLocation": "\\\\BACKUPNAS\\homes\\gsuitebackups"
  "WinsUsername": "BACKUPNAS\\cube",
  "WinsPassword": "12345"

storage.json sample

{
  "EncryptEnabled": true,
  "Type": "NAS",
  "IndexPath": "/opt/cubebackup365/index",
  "DataPath": "/mnt/nas"
}

storage.json Field Definitions

EncryptEnabled: Whether or not the backup data should be encrypted.

true: Encrypt the backup data.
false: Do not encrypt the backup data.
Type: The storage type.

"NAS": Mounted network storage
IndexPath: The storage location for the data index.

The data index should be stored on a local disk (local SSD is strongly recommended).
DataPath: The mounted network storage location for the backup data.

storage.json sample

{
  "EncryptEnabled": true,
  "Type": "S3",
  "IndexPath": "/opt/cubebackup365/index",
  "S3Bucket": "cubebackup-beta-ubuntu",
  "S3Region": "us-east-1",
  "S3AccessKeyId": "AKIAW...4YZEYUY",
  "S3SecretAccessKey": "gCA0U4JG1...99Y5L+DbvpgiDX"
}

storage.json Field Definitions

EncryptEnabled: Whether or not the backup data should be encrypted.

true: Encrypt the backup data.
false: Do not encrypt the backup data.
Type: The storage type.

"S3": Amazon S3
IndexPath: The storage location for the data index.

The data index should be stored on a local disk (local SSD is strongly recommended).
On Windows, double backslashes should be used to separate the directories in the path.
For example:
```
  "IndexPath": "C:\\Program Files\\CubeBackup365\\index"
```
S3Bucket: The name of the S3 bucket.
S3Region: The region of the S3 bucket. For AWS S3 storage regions, please refer to this doc.
S3AccessKeyId: The IAM Access key ID to access the bucket.
S3SecretAccessKey: The IAM Secret Access key to access the bucket.

For more information, please refer to Create an IAM account in Backup Microsoft 365 Data to private Amazon S3 storage.

storage.json sample

{
  "EncryptEnabled": true,
  "Type": "GOOGLE",
  "IndexPath": "/opt/cubebackup365/index",
  "GoogleCredentials": "{\n  \"type\": \"service_account\", ...",
  "GoogleBucket": "cubebackup-beta"
  "GoogleCoolStorageClass": "COLDLINE"
}

storage.json Field Definitions

EncryptEnabled: Whether or not the backup data should be encrypted.

true: Encrypt the backup data.
false: Do not encrypt the backup data.
Type: The storage type.

"GOOGLE": Google Cloud Storage
IndexPath: The storage location for the data index.

The data index should be stored on a local disk (local SSD is strongly recommended).
On Windows, double backslashes should be used to separate the directories in the path.
For example:
```
  "IndexPath": "C:\\Program Files\\CubeBackup365\\index"
```
GoogleCredentials: The service account key to access Google Cloud Storage.
GoogleBucket: The name of the Google Cloud Storage bucket.
GoogleCoolStorageClass: The storage class for the backup data. Coldline is recommended. For more information about Google Cloud storage classes, please visit Storage classes.

"STANDARD" for Standard
"NEARLINE" for Nearline
"COLDLINE" for Coldline
"ARCHIVE" for Archive

storage.json sample

{
  "EncryptEnabled": true,
  "Type": "AZURE",
  "IndexPath": "/opt/cubebackup365/index",
  "AzureAccountName": "cubebackup-beta",
  "AzureAccountKey": "XihUF3ALJ1...gDVvH7x/QgzBxpSEYA==",
  "AzureContainer": "cube-container"
}

storage.json Field Definitions

EncryptEnabled: Whether or not the backup data should be encrypted.

true: Encrypt the backup data.
false: Do not encrypt the backup data.
Type: The storage type.

"AZURE": Azure Blob Storage
IndexPath: The storage location for the data index.

The data index should be stored on a local disk (local SSD is strongly recommended).
On Windows, double backslashes should be used to separate the directories in the path.
For example:
```
  "IndexPath": "C:\\Program Files\\CubeBackup365\\index"
```
AzureAccountName: The name of the Azure storage account.
AzureAccountKey: The Access Key to the storage account.
AzureContainer: The destination container in the Azure storage account.

storage.json sample

{
  "EncryptEnabled": true,
  "Type": "S3C",
  "IndexPath": "/opt/cubebackup365/index",
  "S3Endpoint": "https://s3.us-west-000.backblazeb2.com",
  "S3Bucket": "cubebackup-beta",
  "S3Region": "us-west-000",
  "S3AccessKeyId": "000b4f9...000000007",
  "S3SecretAccessKey": "K000AjHTJ7...MV+FvW9ydI4r7A"
}

storage.json Field Definitions

EncryptEnabled: Whether or not the backup data should be encrypted.

true: Encrypt the backup data.
false: Do not encrypt the backup data.
Type: The storage type.

"S3C": Amazon S3 compatible storage
IndexPath: The storage location for the data index.

The data index should be stored on a local disk (local SSD is strongly recommended).
On Windows, double backslashes should be used to separate the directories in the path.
For example:
```
  "IndexPath": "C:\\Program Files\\CubeBackup365\\index"
```
S3Endpoint: The appropriate service URL for the storage region of the bucket.

For Wasabi, please refer to this doc.
For Backblaze B2, please copy the value of Endpoint and paste with "https://" in the front of the endpoint address.
S3Bucket: The name of the S3 compatible bucket.
S3Region: The region of the S3 compatible bucket.
S3AccessKeyId: The Access key ID to access the bucket
S3SecretAccessKey: The Secret Access key to access the bucket.

For detailed instructions, please refer to Create a Wasabi bucket for Wasabi and Generate the Application Key for Backblaze B2.