Data backup

Install Rclone on Personal Computer

Important Note

This step is only necessary if you want to backup to Google Drive, OneDrive, or Dropbox. You need to perform this on your personal computer with graphical interface (GUI) - not on the server - to obtain the authorization token through a web browser.

Before configuring backups to Google Drive, OneDrive, or Dropbox, you need to install Rclone on your personal computer to obtain the authorization token.

On Windows

Method 1: Using Executable File (Easiest)

1. Download Rclone 64bit or 32bit software to your device at https://rclone.org/downloads/

2. Extract the downloaded zip file, you will have the rclone.exe file

3. Move the rclone.exe file to a folder of your choice, for example: C:\rclone\rclone.exe

4. Open Command Prompt (CMD):

   • Press Windows + R keys
   • Type cmd and press Enter

5. Now you can use Rclone by running the command with the full path, for example:

   C:\rclone\rclone.exe --version

Method 2: Install via Chocolatey (For Advanced Users)

If you have Chocolatey installed, open PowerShell as Administrator and run:

choco install rclone

After installation, you can use the rclone command directly in the terminal.

Method 3: Install via Scoop (For Advanced Users)

If you have Scoop installed, open PowerShell and run:

scoop install rclone

After installation, you can use the rclone command directly in the terminal.

On macOS

Method 1: Using Homebrew (Recommended)

Open Terminal and run:

brew install rclone

Method 2: Using Official Script

Open Terminal and run:

curl https://rclone.org/install.sh | sudo bash

On Linux

Method 1: Using Official Script (Recommended)

Open terminal and run:

curl https://rclone.org/install.sh | sudo bash

Method 2: Install via Package Manager

Ubuntu/Debian

sudo apt update
sudo apt install rclone

Fedora/CentOS/RHEL

sudo dnf install rclone

Arch Linux

sudo pacman -S rclone

---

Backup Management Interface

The Backup management page is divided into 2 main sections:

Backup List

The left section displays a list of configured backups with the following information:

• ID: Backup identifier
• Memo: Description note for the backup
• Drive: Storage service type (Google Drive, OneDrive, Dropbox, SFTP, FTP, S3...)
• Success: Whether the configuration is valid
• Active: Whether the backup is active
• Action: Available operations:
  • Clone configuration to another server
  • View backup script
  • Run backup manually
  • Edit configuration
  • Delete backup

Features:

• "Add New" button: Create a new backup configuration
• Checkboxes: Select multiple backups for bulk deletion
• "Delete Selected" button: Delete selected backups

Backup Histories

The right section displays backup execution history with information:

• ID: Execution identifier
• Name: Backup file name
• Size: Backup file size
• Time: Execution duration
• Status: Success/failure status (green/red dot)
• Log: "View Log" button to see detailed logs
• Date: Creation time

---

Backup to Google Drive

For the configuration process to go smoothly, you need to prepare the following:

1. A Google Drive account dedicated to backing up data

2. Install Rclone on your personal computer (if not already installed)

3. Get Google Drive Token by running the following command:

   Windows (PATH)

   # If rclone is installed to PATH (via Chocolatey/Scoop)
   rclone authorize "drive"

   Windows (.exe)

   # If using the .exe file directly
   C:\rclone\rclone.exe authorize "drive"

   macOS/Linux

   rclone authorize "drive"

   A browser will automatically open, proceed to step 4

4. Select the Google account to back up to

5. Authorize connection to your account

6. Go back to terminal/cmd in step 3, you will see a token code, please copy the entire code

7. Go to server management page and select the server to backup, then click on the "Backups" tab

8. Click the "Add New" button to create a new backup

9. In the configuration form:

   • Choose Drive: Select "Google Drive"
   • Memo: Enter a description note for the backup (e.g., "Daily backup")
   • Backup Google Drive Code: Paste the token code copied in step 6

10. Click the "Save" button to complete

Backup to OneDrive

For the configuration process to go smoothly, you need to prepare the following:

1. A dedicated Microsoft OneDrive account for data backup

2. Install Rclone on your personal computer (if not already installed)

3. Get OneDrive Token by running the following command:

   Windows (PATH)

   # If rclone is installed to PATH (via Chocolatey/Scoop)
   rclone authorize "onedrive"

   Windows (.exe)

   # If using the .exe file directly
   C:\rclone\rclone.exe authorize "onedrive"

   macOS/Linux

   rclone authorize "onedrive"

   A browser will automatically open, proceed to step 4

4. Sign in to your Microsoft account (skip if you're already signed in)

5. Allow connection to your account by pressing Yes

6. Go back to terminal/cmd in step 3, you will see a token code between Paste the following into your remote machine ---> and <---End paste, please copy this code

7. Go to server management page and select the server to backup, then click on the "Backups" tab

8. Click the "Add New" button to create a new backup

9. In the configuration form:

   • Choose Drive: Select "OneDrive"
   • Memo: Enter a description note for the backup
   • Backup OneDrive Code: Paste the token code copied in step 6

10. Click the "Save" button to complete

Backup to DropBox

For the configuration process to go smoothly, you need to prepare the following:

1. A dedicated Dropbox account for data backup

2. Install Rclone on your personal computer (if not already installed)

3. Get Dropbox Token by running the following command:

   Windows (PATH)

   # If rclone is installed to PATH (via Chocolatey/Scoop)
   rclone authorize "dropbox"

   Windows (.exe)

   # If using the .exe file directly
   C:\rclone\rclone.exe authorize "dropbox"

   macOS/Linux

   rclone authorize "dropbox"

   A browser will automatically open, proceed to step 4

4. Sign in to your Dropbox account (skip if you're already signed in)

5. Allow connection to your account by pressing "Agree" or "Allow"

6. Go back to terminal/cmd in step 3, you will see a token code between Paste the following into your remote machine ---> and <---End paste, please copy this code

7. Go to server management page and select the server to backup, then click on the "Backups" tab

8. Click the "Add New" button to create a new backup

9. In the configuration form:

   • Choose Drive: Select "Dropbox"
   • Memo: Enter a description note for the backup
   • Backup Dropbox Code: Paste the token code copied in step 6

10. Click the "Save" button to complete

Backup to SFTP

SFTP (SSH File Transfer Protocol) allows you to backup data to a remote server via SSH.

1. Go to server management page and select the server to backup, then click on the "Backups" tab
2. Click the "Add New" button to create a new backup
3. In the configuration form:
   • Choose Drive: Select "SFTP"
   • Memo: Enter a description note for the backup
   • Host: IP address or domain name of the destination server
   • User: SSH username (default: root)
   • Port: SSH port (default: 22)
   • Authentication Method: Choose authentication method:
     • Password: Use password
     • Private Key: Use SSH key (upload private key file and passphrase if applicable)
4. Click the "Save" button to complete

Backup to FTP

FTP (File Transfer Protocol) allows you to backup data to an FTP server.

1. Go to server management page and select the server to backup, then click on the "Backups" tab
2. Click the "Add New" button to create a new backup
3. In the configuration form:
   • Choose Drive: Select "FTP"
   • Memo: Enter a description note for the backup
   • Host: IP address or domain name of the FTP server
   • User: FTP username
   • Password: FTP password
   • Port: FTP port (default: 21)
4. Click the "Save" button to complete

Backup to Amazon S3

Amazon S3 and S3-compatible services (such as DigitalOcean Spaces, Wasabi, MinIO...) are also supported.

1. Go to server management page and select the server to backup, then click on the "Backups" tab
2. Click the "Add New" button to create a new backup
3. In the configuration form:
   • Choose Drive: Select "S3"
   • Memo: Enter a description note for the backup
   • S3 Provider: Choose service type:
     • S3: Use Amazon S3
     • Other: Use other S3-compatible service
   • S3 Bucket Name: S3 bucket name
   • Access Key ID: AWS Access Key ID
   • Secret Access Key: AWS Secret Access Key
   • Region: S3 bucket region (e.g., us-east-1, ap-southeast-1...)
   • Endpoint (only shown when "Other" is selected): Endpoint address of the S3-compatible service
4. Click the "Save" button to complete

Note about S3

• For Amazon S3: Only fill in Bucket Name, Access Key, Secret Key and Region
• For other services (DigitalOcean Spaces, MinIO...): Select "Other" and fill in the service's Endpoint

---

Advanced Backup Configuration

After successfully creating a backup, you can edit the configuration by clicking the Edit button in the Action column. The edit form includes the following options:

General Settings

• Memo: Description note for the backup
• Active: Enable/disable backup
• Backup Schedule Expression: Cron expression for automatic scheduling, refer to here
• Retention Days: Number of days to keep backups. For example: setting 18 days means backups older than 18 days will be automatically deleted

Advanced Settings

• Exclude Paths: List of directories to exclude from backup (one path per line)
• Include Paths: List of directories to include in backup (one path per line)
• Custom SQL Backup: Custom database backup options
• Transfer Size Limit: Transfer size limitation

Tip

If you want to run a backup immediately, click the Run button in the Action column of the backup list.