> For the complete documentation index, see [llms.txt](https://docs.ava.do/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ava.do/your-avado/keep-your-avado-safe/backups.md).

# Backups

Make encrypted backups of your apps and validator keys on a USB disk plugged into your AVADO, every week by itself, and restore them on the same or a new AVADO.

The **Backup** page makes a locked (encrypted) copy of your apps' data on **your own USB disk**, plugged into your AVADO. Today that covers Vaultwarden, Paperless-ngx, Immich, Home Assistant, and the validator keys with their slashing protection of Teku, Nimbus, Lighthouse and Prysm. The downloaded chain data is never backed up: a client downloads it again by itself.

* Backups are encrypted on the AVADO with **your passphrase**. They never go to AVADO or the internet.
* Once set up, a backup runs **every week by itself** while the disk is plugged in.
* Backups are **incremental**: the first backup copies everything, later ones only add what changed since. Files that didn't change are stored once, so a weekly backup of a big photo library takes little extra space.
* Each new backup is added next to the earlier ones; it doesn't overwrite them. Per app, the **last 4 backups** and **one per month for 12 months** are kept. Older ones are deleted by themselves and their space is freed.

## What you need

* A **USB disk** or stick. Most disk formats work (exFAT, FAT32, NTFS, ext4 and others). How big:
  * **Passwords, settings and validator keys only** (Vaultwarden, Home Assistant, Teku, Nimbus and the like): these are small, so any 16 to 32 GB USB stick is plenty.
  * **With Immich photos and videos or Paperless documents:** a USB SSD or hard disk about **1.5 to 2 times** the size of your library. Thanks to incremental backups the kept copies share their files, so the extra room is for changes and growth.
* A **passphrase**: a short sentence you will remember, at least 10 characters. Write it on paper.

## First backup

Click **Backup** in the sidebar of the AVADO Admin.

1. **Plug a USB disk into your AVADO.** The page lists it with its size. If it isn't found, plug it in again and click **Look again**.
2. **Choose a passphrase.** Type it twice.
3. Tick **I wrote the passphrase down and keep it safe.**
4. Leave **Back up every week while the disk is plugged in** on.
5. Click **Back up now**.

<figure><img src="https://2996176873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0YTdumceG05uJMtaEgaT%2Fuploads%2Fgit-blob-a653ba7daec3b7d66ec1620a80a25278d23e9a28%2Fbackup-first-time.png?alt=media" alt="Back up your AVADO: 1. Plug a USB disk into your AVADO, 2. Choose a passphrase, the passphrase warning, and Back up now"><figcaption><p>The Backup page the first time.</p></figcaption></figure>

{% hint style="danger" %}
**The passphrase is the only key to your backups.** Without it nobody can open them, not even AVADO. Write it down on paper and keep it somewhere safe, away from the AVADO.
{% endhint %}

The page shows the progress, for example "Backing up Vaultwarden (1 of 3)". You can close the page; the apps keep running. Don't unplug the disk until it's done.

## Everyday use

The page shows when the last backup ran, which apps it holds and how big it is.

<figure><img src="https://2996176873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0YTdumceG05uJMtaEgaT%2Fuploads%2Fgit-blob-e34d7c207f9875808ae584fd2831d7f8bec7f48b%2Fbackup-done.png?alt=media" alt="Backups: saved encrypted to the USB disk, last backup with the apps and size, Back up now, Restore, Back up every week"><figcaption><p>After a backup.</p></figcaption></figure>

* Leave the disk plugged in for the weekly backup, or plug it in now and then and click **Back up now**.
* **More options** shows what each app includes. Big items, such as Immich's photos and videos or Paperless's documents, can be ticked or left out ("Can be very large").
* **More options** also lets you use another disk, a new passphrase, or a **NAS** (a network disk at home) instead of a USB disk.

## Restore

Use this after a problem, or to move your apps to a new AVADO.

1. Install the apps you want back first (from the **DappStore**).
2. Plug the backup disk into the AVADO and open **Backup**.
3. Click **Restore** (or **Restore a backup from another AVADO** on a new box).
4. **Pick the backup:** choose the disk, click **Show backups** and choose one by its date.
5. **Type its passphrase.**
6. **Choose what to restore** and click **Restore**.

The apps stop while they are restored. What they held before is kept aside on the AVADO, not deleted.

### Validator keys: never run them in two places

Validator apps (Teku, Nimbus and others) are never ticked by default. If you tick one, a red box appears:

<figure><img src="https://2996176873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0YTdumceG05uJMtaEgaT%2Fuploads%2Fgit-blob-54cab3f76a818a60c3d36950383b9d5efa36b8fb%2Fbackup-restore-validator.png?alt=media" alt="Restore from a backup with Teku ticked: the red box Validator keys: never run them in two places, and the sentence to confirm" width="420"><figcaption><p>Restoring validator keys needs one more confirmation.</p></figcaption></figure>

{% hint style="danger" %}
If the same validator keys sign on two machines, part of your stake is taken away (**slashed**). Before you restore validator keys, **switch the old AVADO off for good, or remove the keys from it**. Only then tick **The old AVADO is switched off, or these keys are removed from it.**
{% endhint %}

After the restore, the validator app **stays stopped**. The page has a link to it. Start it yourself only when you are sure the old AVADO is off for good.

## If something is wrong

* **"No USB disk found":** plug the disk into another USB port and click **Look again**. A disk in a format the AVADO can't use is listed with the reason.
* **"The backup disk is full":** use a bigger disk, or untick large items such as photos under **More options**.
* **"The passphrase is wrong":** check for typing mistakes, capitals and spaces. Without the right passphrase the backup can't be opened.
* **An app shows "install it first":** install that app from the DappStore, then come back and restore.
* **"Your AVADO needs an update before it can make backups":** update in **System → Updates**.
* **A message about a validator key that is also in another app on this AVADO:** remove it there first, as the message says, so the keys never run twice.

Still stuck? Contact <support@ava.do> before you restore validator keys.
