# UrBackup Server & Client Installation Guide

### <span style="white-space: pre-wrap;">1. </span>**Prerequisites**

- <span style="white-space: pre-wrap;">You're operating as </span>**root**<span style="white-space: pre-wrap;">—no need for </span>`<span class="editor-theme-code">sudo</span>`<span style="white-space: pre-wrap;"> (and it may not even be installed).</span>
- <span style="white-space: pre-wrap;">On Linux, use filesystems </span>**EXT4**<span style="white-space: pre-wrap;"> or </span>**XFS**<span style="white-space: pre-wrap;"> (necessary for image downloads)</span>
- <span style="white-space: pre-wrap;">Have at least </span>**1–2 GB free**<span style="white-space: pre-wrap;"> in </span>`<span class="editor-theme-code">/tmp</span>`<span style="white-space: pre-wrap;"> (default unpacking site).</span>

---

### <span style="white-space: pre-wrap;">2. </span>**Install UrBackup Server (Debian/Ubuntu-based)**

```bash
# Update base packages
apt update
apt install curl gnupg2 software-properties-common
```

#### Option A: PPA method

```bash
add-apt-repository ppa:uroni/urbackup
apt update
apt install urbackup-server
```

#### Option B: Direct .deb download

```bash
wget https://hndl.urbackup.org/Server/2.5.33/urbackup-server_2.5.33_amd64.deb
dpkg -i urbackup-server_2.5.33_amd64.deb
apt install -f   # fix missing dependencies
```

> <span style="white-space: pre-wrap;">You’ll be prompted to choose a backup directory—e.g., </span>`<span class="editor-theme-code">/media/backup/urbackup</span>`

---

### <span style="white-space: pre-wrap;">3. </span>**Enable &amp; Verify Service**

```bash
systemctl enable urbackupsrv
systemctl start urbackupsrv
systemctl status urbackupsrv
ss -antpl | grep -E "5541[34]"
```

- <span style="white-space: pre-wrap;">Ports: </span>**55413**<span style="white-space: pre-wrap;"> (FastCGI), </span>**55414**<span style="white-space: pre-wrap;"> (HTTP) </span>

---

### <span style="white-space: pre-wrap;">4. </span>**Access Web Interface**

<span style="white-space: pre-wrap;">Open your browser to </span>`<span class="editor-theme-code">http://<server-ip>:55414</span>`.

1. <span style="white-space: pre-wrap;">Go to </span>**Settings → Users**<span style="white-space: pre-wrap;">, create an </span>**admin account**<span style="white-space: pre-wrap;"> to secure the web UI</span>
2. <span style="white-space: pre-wrap;">Tweak general settings like backup retention, temporary path, etc., via </span>`<span class="editor-theme-code">/etc/default/urbackupsrv</span>`<span style="white-space: pre-wrap;"> or the UI</span>

---

### <span style="white-space: pre-wrap;">5. </span>**Install UrBackup Client (Linux)**

On the client machine (as root):

```bash
TF=$(mktemp)
wget "https://hndl.urbackup.org/Client/2.5.25/UrBackup%20Client%20Linux%202.5.25.sh" -O "$TF"
sh "$TF"
rm -f "$TF"
```

- <span style="white-space: pre-wrap;">You’ll be asked to choose a </span>**snapshot mechanism**:
    - **LVM**<span style="white-space: pre-wrap;">, </span>**datto**<span style="white-space: pre-wrap;">, or </span>**none**<span style="white-space: pre-wrap;"> (bare-metal backup needs LVM or root snapshot).</span>

---

### <span style="white-space: pre-wrap;">6. </span>**Register &amp; Configure Client**

<span style="white-space: pre-wrap;">Back on the </span>**server web UI**:

1. <span style="white-space: pre-wrap;">Click </span>**“Add new client”**, choose network or internet type.
2. Copy the install command and run it on the client (as above).

On the client, add directories to back up:

```bash
urbackupclientctl add-backupdir -d /path/to/important
```

Repeat for all directories you want to include

### <span style="white-space: pre-wrap;">7. </span>**Monitor &amp; Manage Backups**

- <span style="white-space: pre-wrap;">Use </span>**Status**<span style="white-space: pre-wrap;">, </span>**Backups**<span style="white-space: pre-wrap;">, and </span>**Activities**<span style="white-space: pre-wrap;"> tabs to check client status and jobs</span>
- **Delete old backups**<span style="white-space: pre-wrap;"> manually in the UI or run </span>`<span class="editor-theme-code">urbackupsrv cleanup</span>`<span style="white-space: pre-wrap;"> on the server for automated cleanup </span>

### <span style="white-space: pre-wrap;">8. </span>**Uninstall Client**<span style="white-space: pre-wrap;"> (if needed)</span>

```bash
uninstall_urbackupclient
```

---

## **Why UrBackup?**

- Simple web interface
- <span style="white-space: pre-wrap;">Supports </span>**file-level + image backups**<span style="white-space: pre-wrap;"> while live</span>
- <span style="white-space: pre-wrap;">Efficient </span>**deduplication**<span style="white-space: pre-wrap;"> – minimizes storage use during repeated backups </span>
- Works across Linux, Windows, FreeBSD

---

### **Quick Tips**

- <span style="white-space: pre-wrap;">As root, </span>**drop `<strong class="editor-theme-bold editor-theme-code">sudo</strong>`.**
- <span style="white-space: pre-wrap;">Choose </span>**EXT4**<span style="white-space: pre-wrap;"> or </span>**XFS**<span style="white-space: pre-wrap;"> on servers for image backup support.</span>
- <span style="white-space: pre-wrap;">Pick the right </span>**snapshot mode**<span style="white-space: pre-wrap;"> on clients: LVM or none.</span>
- <span style="white-space: pre-wrap;">Always protect your </span>**web UI**<span style="white-space: pre-wrap;"> with an admin account.</span>
- <span style="white-space: pre-wrap;">Monitor </span>**ports 55413/55414**<span style="white-space: pre-wrap;"> and ensure they're reachable.</span>