Documentation

Backup & Restore

Protect your Huntarr configuration with automatic and manual backups.

Overview

  • Huntarr can backup its entire database (settings, schedules, history, etc.)
  • Backups are stored as files in your /config/backups directory
  • Both automatic and manual backups are supported
  • Restore from any backup to recover your configuration

Creating a Manual Backup

  1. Go to Settings > Backup & Restore
  2. Click "Create Backup"
  3. A backup file is created with a timestamp
  4. The backup appears in the list below

Automatic Backups

  • Huntarr creates automatic backups on a schedule
  • Configure the interval in Settings
  • Old backups are automatically cleaned up based on retention settings

Restoring from Backup

  1. Go to Settings > Backup & Restore
  2. Find the backup you want to restore
  3. Click "Restore"
  4. Confirm the action
  5. Huntarr restarts with the restored configuration
Restoring a backup

Restoring a backup replaces ALL current settings. This action cannot be undone. Make sure you have a current backup before restoring an older one.

Uploading a Backup

  • You can upload a backup file from another Huntarr instance
  • Useful for migrating between servers
  • Click "Upload Backup" and select the file

Deleting the Database

  • In emergencies, you can delete the entire Huntarr database
  • This resets Huntarr to a fresh state (setup wizard appears)
  • All settings, schedules, and history are lost
Deleting the database

Deleting the database is irreversible. Only use this as a last resort if your database is corrupted and cannot be restored from backup.

Tips

  • Create a backup before major changes (new apps, schedule overhauls)
  • Keep at least 3 recent backups
  • Test restoring from backup periodically to ensure they work
  • Store backup files externally for disaster recovery