Database Sync and Backups¶
Output files, database synchronization, and backups serve different purposes:
| What you need | Use |
|---|---|
| Playlist and EPG links for a player | Cloud output publishing |
| Share the working database between installations | Database synchronization through a configured cloud provider or XC Server |
| Recover sources, layouts, users, and settings | A retained database backup or a stopped installation's data-directory copy |
Cloud database synchronization and backup controls require Pro. Cloud playlist/EPG publishing is available in the core workflow. See Free vs Pro.
Preserve the current desktop installation¶
Before updating, restoring, or making a large configuration change:
- Wait for synchronization, output, and backup operations to finish.
- Close IPTVBoss normally and allow its shutdown backup work to complete. Stop any noGUI or server process using the same database.
- Locate the active application data directory. Use the configured directory if the installation overrides the default.
- Copy the data directory, including
dbandbackup, into a dated folder outside the installation directory. - Confirm the copy contains the expected files and retain another copy on separate storage.
A data-directory copy preserves the installation files; it is not the same as the database backup file selected by the application's restore dialog. Follow Restore a Database Backup when using that dialog.
Configure database synchronization¶
- Identify which installation contains the database you want to keep. This is the authoritative copy.
- Open Settings → IPTVBoss Settings and review Cloud & Backups.
- For Dropbox or Google Drive, complete Cloud Provider Setup. For XC Server, follow desktop pairing.
- Review database synchronization and backup retention settings for the selected provider.
- Save the settings and allow the backup operation to complete.
- Check backup history or the configured provider for the resulting backup and review the logs for failures.
Keep a dated backup from before a major change. Synchronizing the latest database does not by itself preserve an older working configuration.
Switch from XC Server to Dropbox or Google Drive¶
Before switching, configure and authorize the chosen cloud provider on the installations that will use it. In the desktop's Cloud & Backups settings, leave Cloud Sync Enabled selected, choose Dropbox or Google Drive, and select Save Settings.
IPTVBoss first asks the paired XC Server to transfer database synchronization to that provider and release the desktop's editing lease. The settings dialog shows Saving Cloud Settings while this completes. Another editor's active lease or an ongoing database operation blocks the handoff. If Database Sync Provider Was Not Changed appears, resolve the reported condition and retry; the desktop's provider setting has not been changed.
After a successful handoff, cloud sync state is refreshed with progress shown. Check the selected provider and backup status on both installations. Pausing XC synchronization alone does not transfer database synchronization to Dropbox or Google Drive.
When leaving Dropbox or Google Drive, IPTVBoss releases any cloud lock owned by this installation before applying the new settings. Disabling XC database synchronization releases the desktop's editing lease.
Closing a desktop synchronized with XC Server¶
With XC Server database synchronization and backups enabled, allow shutdown to finish creating the backup, uploading it, and waiting for the server. The desktop restores the server database on its next startup before editing resumes.
If Shutdown needs attention appears, use Retry or, when available, Exit with Local Backup. Record the displayed backup path. Exiting with a local backup preserves a recovery copy but does not confirm successful server publication. Pending publication or restore work is checked on the next startup, and editing remains paused until reconciliation succeeds or you explicitly unlink the server.
Follow XC shutdown or startup needs attention for recovery options.
Back up or update an XC Server¶
Use the instructions for the process that owns the server database:
- Docker backup, update, and restore/rollback.
- Linux service.
- macOS service.
- Windows startup task.
- Desktop Server Dashboard for Database Backup History, Download Backup, and Restore Backup on a paired installation.
For recovery, choose the appropriate method in Restore a Database Backup. To reconnect an installation without replacing its database, use XC paired-code recovery.