Skip to main content

Restore Application Backup

Take care while restoring an application backup to avoid accidental overwrites of data. Use at your own risk and only proceed if you are comfortable navigating a Linux terminal. If you are unsure, see our Your Shell - A Beginner's Guide to get familiarized with the Linux terminal. Or you can request official support by submitting a ticket.

In this guide, we will show you how to create and restore a backup from one of the officially supported applications. The majority of applications installed from the User Control Panel will have a configuration directory in ~/.apps. While torrent clients and some other applications are excepted from this, and you will find their configuration directories in ~/.config.


An application backup is created when you press Upgrade & Repair on the UCP, or by manually executing app-<appname> upgrade or app-<appname> repair. Application backups are compressed into ZIP archives, and are stored in ~/.apps/backup. You can also create application backups manually by executing app-<appname> backup.


To create an application backup, follow the below instructions:

  • Connect to your service via SSH
  • Once connected, execute the below command to create an application backup.
    • Make sure to replace <appname> with the name of the application you want to create a backup for. For example, to create a backup for Deluge, the command would be app-deluge backup.
app-<appname> backup
  • Once the command has been successfully executed, a backup has been created in ~/.apps/backup


To restore an application backup, follow the below instructions:

  • Connect to your service via SSH
  • Before resting the backup, stop the application from the UCP, or by executing the following command:
app-<appname> stop
  • Manually backup the current application configuration directory by executing the following command:
cp -r ~/.apps/<appname> ~/.apps/<appname>.bak
  • If the previous command was successful and without any errors, you can proceed with the process.
  • Next, navigate to the application backup directory and list the directory contents:
ls -lah ~/.apps/backup
  • The previous command will automatically list all the individual application backups with the naming format: appname-date_time_uniqueID.
  • Next, select which backup you want to restore, and copy the filename.
  • Next, to extract the backup, execute one of the following commands and include the copied filename.
    • If the file name ends with .zip, use the unzip command.
    • If the file name ends with .tar.gz, use the tar command.
unzip ~/.apps/backup/<appname> -d ~/
tar -xzvf ~/.apps/backup/<appname> -C ~/
  • Once the extraction has finished, the application can be restarted.
app-<appname> restart
  • Wait 1-2 minutes and check if the application is reachable via its Web UI.
  • If the application still is not functioning, you can repeat the restoration procedure and try an older backup.