# Restore Application Backup

<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/books/secure-shell-%28ssh%29/page/your-ultracc-shell-a-beginners-guide">Your Ultra.cc Shell - A Beginner's Guide</a> to get familiarized with the Linux terminal. Or you can request official support by submitting a <a href="https://my.ultra.cc/submitticket.php">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](https://cp.ultra.cc) 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](https://cp.ultra.cc), 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](https://docs.ultra.cc/books/secure-shell-%28ssh%29/page/how-to-connect-to-your-ultracc-slot-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`.

```sh
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](https://docs.ultra.cc/books/secure-shell-%28ssh%29/page/how-to-connect-to-your-ultracc-slot-via-ssh)
- Before resting the backup, stop the application from the [UCP](https://cp.ultra.cc), or by executing the following command:

```
app-<appname> stop
```

- Manually backup the current application configuration directory by executing the following command:

```sh
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:

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

```sh
unzip ~/.apps/backup/<appname>-2000-00-00_00-00_00000000.zip -d ~/
```

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