Restore Application Backup

super-embed:
<p class="callout warning">
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 <a href="<https://docs.ultra.cc/connection-details/ssh/your-ultra-shell-a-beginners-guide>">Your Ultra Shell - A Beginner's Guide</a> to get familiarized with the Linux terminal. Or you can request official support by <a href="[<https://my.ultra.cc/submitticket.php>](<https://my.ultra.cc/submitticket.php>)">submitting a ticket</a>.
</p>

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