Articles
AWS S3 Setup for hTech OS Backup Module
AWS S3 Setup for hTech OS Backup Module
This article shows how to create an AWS account,...
Best Practice: Testing Your Backups (Do This Monthly)
Why Testing Matters
A backup that cannot restore is not a real backup. Testing ensures your...
Choosing a Storage Provider (Which One Should I Use?)
Provider Options
Local Storage (fast, simplest, but not off-site)
S3 / S3-Compatible...
Common Errors (All S3 Providers)
This article covers the most common errors encountered when configuring AWS S3 or S3-compatible...
Cron & Automation: How Scheduling Works
Cron and Automation: How Scheduling Works
This module uses a server cron job to run automated...
Dropbox Troubleshooting: Common Errors & Fixes
Common Dropbox Errors
401 Unauthorized
Refresh token is invalid/revoked
App key/secret...
Dropbox: Understanding App Permissions (Scopes) for Backups
Overview
Dropbox uses OAuth scopes to control what your app can do. If scopes are missing,...
FAQ: Common Questions (Off-Site Backups)
Do I need off-site backups?
Yes. Local backups can be lost if the server fails or is...
Google Drive Troubleshooting: Common Errors & Fixes
Common Google Drive Errors
401 Unauthorized
Refresh token is invalid or revoked
Client...
Google Drive – Connect to hTech OS Backup Module
The hTech OS Backup Module supports two ways to store backups in Google Drive.
This article...
Google Drive – How to Connect Using OAuth 2.0 (Advanced)
The hTech OS Backup Module supports two ways to authenticate with Google Drive using OAuth 2.0....
Google Drive: Folder Selection & Folder ID Tips
Why Folder IDs Matter
Some Google Drive configurations require a destination folder ID to upload...
How to Create Dropbox App Key, App Secret, and Refresh Token
This article explains how to create a Dropbox App Key, App Secret, and a Refresh Token for use...
How to Create a Dropbox Access Token for the hTech OS Backup Module
This article explains how to create a Dropbox access token that can be used with the hTech OS...
How to Delete a Backup (Local vs Remote)
Deletion Types
Delete Local: removes the backup archive from your WHMCS server
Delete...
How to Restore From a Backup (Recommended Process)
Important
Restores are high-impact. When possible, test restores on staging first....
How to Run a Manual Backup
Steps
Open hTech OS Backup in WHMCS Admin
Go to the Backups section
Click Create...
How to Set Up a Scheduled Backup
How to Verify a Remote Backup
What “Verify Remote” Does
Remote verification checks whether the uploaded backup exists in your...
In-App Updates: How Updates Work (Admin)
Overview
If your version includes in-app updates, you can check for updates, download packages,...
Installing & Activating the hTech OS Backup Module
Overview
This guide walks you through installing and activating the hTech OS Backup addon module...
Licensing Troubleshooting: Common Activation & Verification Issues
Common Symptoms
License shows invalid
Updates cannot be downloaded
Verify endpoint...
Local Storage: Setup & Best Practices
Overview
Local storage saves backups on the WHMCS server itself. This is the easiest option, but...
Module Overview: What hTech OS Backup Does
What This Module Is
hTech OS Backup is a WHMCS addon module that helps you create backups of...
Orphans & Unverifiable Backups: What They Are and What To Do
Definitions
Orphan: The module has a record of a backup, but the local and/or remote file...
Performance & Timeouts: Preventing “Frozen Browser” and Long Operations
Why This Happens
Backups (especially remote uploads) can be large and time-consuming. If actions...
Quick Start Checklist (5 Minutes)
Quick Start Checklist
Install & Activate the module in WHMCS
Select a Storage...
Retention & Cleanup: Keeping Only the Backups You Need
What Retention Means
Retention controls how many backup copies you keep before older backups are...
S3-Compatible Providers: Required Fields Explained
What You Need for S3-Compatible Storage
S3-compatible providers typically require:
Access...
S3-Compatible Troubleshooting: Backblaze B2 S3 (Common Quirks)
Common Backblaze B2 S3 Issues
Must use the correct S3 endpoint for your B2 bucket
Key...
S3-Compatible Troubleshooting: Cloudflare R2 (Common Quirks)
Common Cloudflare R2 Issues
R2 requires an account-specific endpoint
Some tools require...
S3-Compatible Troubleshooting: Wasabi (Common Quirks)
Common Wasabi Issues
Endpoint must match the bucket region
Incorrect region causes...
Security Best Practices for Off-Site Backups
Credential Handling
Use least-privilege credentials only
Do not use root/admin cloud...
System Health Check: What It Tests and How to Use It
What the Health Check Does
The System Health Check is designed to quickly identify problems that...
System Requirements & Server Recommendations
Recommended Requirements
Recent supported WHMCS version
PHP with cURL, OpenSSL, JSON...
Troubleshooting: Backup Fails to Create (Archive Build Errors)
Common Causes
Insufficient disk space for temporary archive creation
Permission denied...
Troubleshooting: In-App Update Download Fails
Common Causes
Server cannot reach the update URL (firewall/DNS)
License headers invalid...
Troubleshooting: Upload Fails (Remote Provider Errors)
Common Causes
Invalid credentials
Wrong region/endpoint (S3-compatible)
Destination...
Troubleshooting: “Oops! Something went wrong…” (Common Causes)
What This Means
The WHMCS “Oops!” message usually indicates a PHP exception or fatal error....
Understanding Backup Types (What is Included)
What a Backup Typically Includes
Backup contents can vary by module version and configuration. A...
Understanding Status Messages in Recent Backups
Where to Look
Each backup entry may include a status message describing what happened during...
Using S3-Compatible Storage Providers
The hTech OS Backup Module supports AWS S3 and S3-compatible object storage providers such as:...