📘

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

If you require further assistance, you can open a support ticket here!

Feedback and suggestions regarding this article are welcome on our Discord server