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 Ultra.cc 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 Ultra.cc 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.

Introduction

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.

Backup

To create an application backup, follow the below instructions:

• Connect to your Ultra.cc 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

Restore

To restore an application backup, follow the below instructions:

• Connect to your Ultra.cc 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>-2000-00-00_00-00_00000000.zip -d ~/

tar -xzvf ~/.apps/backup/<appname>-2000-00-00_00-00_00000000.zip -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.