# Back up with UrBackup

{{< recipes-disclaimer >}}

## urbackup-Infscape Backup Guide

This guide can be used to deploy a Infscape Backup appliance on Exoscale and configure SOS as an S3 backup endpoint.

You can access the [full UrBackup documentation](https://www.urbackup.org/admin_guide_app.pdf) for additional information.

## Installation

Follow the [UrBackup guide](https://www.infscape.com/urbackup-appliance-download/) to install a cloud instance.

### Prepare the Security Group

The Infscape instance requires the following ports to be open in the security-group:

* TCP/22 for SSH access (only required during installation, can be removed later)
* TCP/80 for HTTP
* TCP/443 for https

### Prepare the Compute instance

Create a new instance with the following settings:

* Debian 10 Bullseye as template
* At least 4 GB RAM (a medium or higher instance required)
* At least 50 GB disk (required for local caching of backup data chunks before uploading to SOS)

### Prepare the SOS Bucket and API Key

Create a SOS bucket in your preferred zone. Note that traffic between [Exoscale zones](https://www.exoscale.com/datacenters/) is free. You can set different zones for the bucket and for the Infscape appliance to achieve geo-redundancy with your backups.

* Create a bucket with a unique name.
* Create an API key restricted to the service SOS and the created bucket. Write down the API key and secret.

![](urbackup-infscape_apikey.png "API Key")

### Install Infscape

* SSH into the created Debian system.
* Initiate the installation process:

```bash
wget https://dl3.infscape.com/images/urbackup-app-10-13.sh && bash urbackup-app-10-13.sh
```

* Agree to the installation. A password will be shown in the terminal. Make sure to save the password, as it will be used to access the web management interface.

![](urbackup-infscape_install.png "Installation")

* After a short time, the appliance will reboot itself. Due to a small bug, we need to reboot it again: in the instance detail view in the Portal, click on the `...` more actions button and then click on `Reboot`.

This is how the console looks before the appliance is rebooted:

![](urbackup-infscape_nonetwork.png "Before reboot")

* You can use the console to validate the appliance has the public IP configured.

![](urbackup-infscape_network.png "Network settings")

## Configure Infscape and the License

* Open a browser and navigate to the public IP of the Infscape appliance using HTTP. For example, <http://"public-ip"/>.
* Provide the password generated during installation process

![](urbackup-infscape_firstlogin.png "First Login")

* If you do not yet own a license key, login at: [infscape.com](https://www.infscape.com/). If you just want to start, select a free Community Edition license key.
* If you do not have a UrBackup account, register with a valid email address and password. This account will be used to access this instance's web interface. You will also receive event-based email notifications (for example, if your Infscape appliance is offline).
* Provide the appliance name and the license key.
* Use the public IP or a DNS pointing to the public IP for clients to connect.

![](urbackup-infscape_register.png "Infscape Register")

## Configure HTTPS (Optional but Highly Recommended)

Note that you require a DNS entry to enable HTTPS.

* Login with the new password to the appliance.
* Navigate to **Settings**, then **System** and click on **Setup SSL/HTTPS**.

![](urbackup-infscape_setupssl.png "Setup SSL")

* Provide the DNS name of the appliance. Then enable the redirect and accept the **Let's Encrypt Subscriber Agreement**.
* Click on **Save** to enable HTTPS. The web interface will be unresponsive for about 30 seconds while HTTPS is configured.

![](urbackup-infscape_sslsettings.png "SSL settings")

## Configure Infscape Server Settings to use SSL for Backups (Optional but Highly Recommended)

Note that SSL must be enabled.

* Navigate to **Settings**, then **Internet**.
* Set **Internet Server name/IP** to `<127.0.0.1>`.
* Let "**Internet Server port** stay on the preconfigured value of `55415`.
* Set **Connect via HTTP(S) proxy** to **your DNS entry**.
![](urbackup-infscape_serversettings.png "Server settings")

### Configure Cloud Storage

* Navigate to the **Status** page.
* Click on **Use system disk as cache and setup cloud storage** (a large blue button).

![](urbackup-infscape_setupsos.png "Setup SOS")

* Agree and enter the cloud storage information.

![](urbackup-infscape_detailsos.png "Details SOS")

* **Note**: Write down the cloud storage encryption key and store it safely. This key is **mandatory to decrypt your backups** if the appliance is lost.
* Click on **Select/Confirm cloud storage** to finish.
* Navigate to **Settings**, then **Storage** to validate that the cloud storage is used.

![](urbackup-infscape_verifysos.png "Verify SOS")