Overview
Backuplys Sync Backup Records feature allows administrators to synchronize metadata of remotely stored backups to a new or current server.
This is particularly useful during disaster recovery scenarios when metadata needs to be re-imported to enable restore operations.
If a backup metadata file is already present on the server, it will be skipped during the sync process.
Once the sync is complete, you will be able to view the list of available remote backups in the Restore Wizard.
Once the synchronization is complete, the synced backup records will be available in the Restore & Download Wizard, allowing admins to restore them directly.
Requirement
Before initiating the sync process, ensure the following:
- The remote server must be accessible via one of the supported protocols: SSH, FTP, S3, Google Drive, or OneDrive.
- Each backup must include its corresponding metadata file (
.json
). Backuply uses these metadata files to register the backup records on the local server.
- Example :
A valid backup folder should contain both:chinmay_backup_full_2025-07-02_13-38-21.tar.gz
chinmay_backup_full_2025-07-02_13-38-21.tar.gz.json

Sync Remote Backups
Follow the steps below to synchronize backup records from a remote server:
1. Add a Backup Server :
First, you need to add a backup server to Backuply. This server must contain the backups and associated metadata files created using Backuply.
To add backup server navigate to Backuply Admin Panel > Backup Servers > Add backup servers
Backuply location must be valid where Backuply backups are stored
2. Navigate to Sync backup :
Once the backup server is added:
Visit the List Backup Servers page.
Click on the Sync icon next to the server you wish to sync.

This will take you to the Sync Backups page with the selected backup server pre-filled.
3. Start Sync Process :
Verify the backup server and remote backup location.
Click on Submit to initiate the sync process.

Backuply will then begin scanning the remote directory for .json
metadata files and will sync those records to the local server.
You can monitor the sync progress and logs via the Tasks Wizard.


Once the synchronization is complete, if any backup metadata files were successfully synced from the remote server, those backup records will automatically appear in both the Restore & Download Wizard.
Administrators can then restore the synced backups directly from the control panel.
