Google Drive – Connect to hTech OS Backup Module Print

The hTech OS Backup Module supports two ways to store backups in Google Drive.

This article explains both options and walks you through how to configure each one.

Google Drive Storage Options

You may choose either of the following:

1. Automatic Folder (Recommended) – The module creates and manages the folder for you.
2. Custom Folder – You choose an existing Google Drive folder by providing its Folder ID.

Option 1: Automatic Google Drive Folder (Recommended)

This is the easiest and safest option.

The module will:

• Create a dedicated folder in Google Drive
• Store the Folder ID automatically
• Reuse the folder for all future backups

How to Use Automatic Folder

1. Complete Google Drive authorization (Client ID, Client Secret, Refresh Token).
2. Go to WHMCS Admin → Addons → hTech OS Backup → Settings.
3. Select Google Drive as the storage provider.
4. Leave the Destination Folder ID field blank.
5. Save settings.
6. Click Verify Remote or run a test backup.

The module will automatically create a folder such as:

• hTech OS Backups

Option 2: Use a Custom Google Drive Folder

This option allows you to store backups in a specific folder you choose.

Use this if:

• You already have an organized Drive structure
• You want backups stored inside an existing folder
• You manage multiple systems using one Drive account

Step 1: Create or Choose a Folder in Google Drive

1. Open Google Drive.
2. Create a new folder or open an existing one.
3. Example folder name: WHMCS Backups

Step 2: Get the Google Drive Folder ID

Once the folder is open, look at the browser address bar.

The URL will look similar to:

https://drive.google.com/drive/folders/FOLDER_ID_HERE

The Folder ID is the long string after /folders/.

Example:

• Folder ID: 1aBcD_EFgHiJKlMNOpQrSTuVwXyZ

Important: Copy only the Folder ID, not the full URL.

Step 3: Enter the Folder ID in WHMCS

1. Go to WHMCS Admin → Addons → hTech OS Backup → Settings.
2. Select Google Drive as the storage provider.
3. Paste the Folder ID into Destination Folder ID.
4. Save settings.
5. Click Verify Remote or run a test backup.

Google Drive Authorization (Required for Both Options)

Both storage options require Google Drive authorization using OAuth 2.0.

This process creates a refresh token that allows WHMCS to upload backups automatically.

Please follow the separate article:

• Google Drive – How to Connect Using OAuth 2.0

Important Notes

• The refresh token does not expire unless revoked.
• The Google account used must own or have access to the destination folder.
• Do not delete the folder after configuration.
• Do not share Client Secret or Refresh Token.

Troubleshooting

• Verify Remote fails: Confirm Folder ID is correct and belongs to the authorized Google account.
• Permission denied: Ensure the folder is not restricted or owned by another account.
• No files appear: Run a manual backup to confirm uploads.

If issues persist, run the module System Health Check or contact support.