Skip to content

Backup & Restore

AzuraCast includes a built-in utility for backing up your installation, including your database, all stations and their settings, and optionally the local media tied with the station(s).

Ways to Backup

Via the Web Interface

The “System Administration” section of your AzuraCast web interface has a dedicated “Backup” page, where you can configure periodic automated backups, run a one-time backup and download existing backup files.

Backups run through the web panel do not interrupt your broadcasts or disconnect your listeners.

Via the Command Line

If you want more control over where your backup files are going, or want to take advantage of pre-existing tools (like cron tasks) to handle the backup, you can use the Docker Utility Tool to generate backups as well.

The most basic version of this command is:

Terminal window
cd /var/azuracast
./ backup

You can also pass the —exclude-media flag to back up just the database and statistics, but not the media itself, which significantly reduces the backup file size (but you should make sure to back your media up elsewhere):

Terminal window
cd /var/azuracast
./ backup --exclude-media

Both .zip and .tar.gz formats are supported for backups. The correct format will automatically be determined by the extension of the filename you specify for the backup file.

Restoring a Backup

These are the general steps for restoring a backup of AzuraCast:

  1. Install AzuraCast (see our guide)
    • If you have an older backup file and encounter issues with restoring, install AzuraCast on stable by answering Y to the question “Prefer stable release versions of AzuraCast?”
  2. After the installation is finished, run the restore command:
    • ./ restore
  3. If you have used the stable installation due to an older backup file you should now switch back to the rolling-release via the following command and answer N to the question if you want to use the stable version:
    • ./ setup-release
  4. Finally run the following command to update the installation to the current rolling-release version:
    • ./ update