# Backups

## Overview

Labii provides a backup feature to help you safeguard your data by creating downloadable copies of all your records and uploaded files. These backups can be stored in external locations and used for recovery in case of data loss or corruption.

{% hint style="warning" %}
**Important:** Backups consume additional computing resources. Charges will apply based on the size of the backup. Pricing is shown during the backup creation process.
{% endhint %}

{% hint style="danger" %}
**Tip:** To avoid ongoing storage charges, it is recommended to delete the backup from Labii once it has been downloaded.
{% endhint %}

## Accessing the Backup

To manage backups:

1. Navigate to the Side Menu
2. Click Settings
3. Select Backups

## List View

The list view shows all your backups along with their statuses and basic information.

![](https://3607108856-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LHVg57XIRcjV-Vbubtn%2Fuploads%2Fgit-blob-3f03f95700edfaa9c460e3a6eb3e9e42af509483%2Fbackups-list.webp?alt=media)

### Searching Backups

To locate a specific backup:

* Use the Search bar at the top of the list view
* Enter a keyword and click Search
* To reset the list, click Clear

### Filtering Backups

Use filters to narrow down the list of backups:

* All backups – Show all backups
* Backups completed – Show only completed backups
* Backups in progress – Show backups currently being generated
* Backups with errors – Show failed backups

## Backup Details

Click on a backup name to open its detail view. From here, you can view all metadata and download the backup.

Each backup contains the following information:

* **Sid** - Unique identifier of the backup
* **Name** - Backup name provided at creation
* **Description** - Optional description of the backup
* **Status** - the status of the backup.
  * **Completed**, the backup is successfully completed and ready to be downloaded
  * **In Progress**, a Labii job is preparing the backup
  * **Error**, the backup job has encounter an error.
* **Versions** - Number of version records included
* **Files** - Number of uploaded files included
* **File Size** - Total size of the backup
* **File Path** - Download link
* **Date Expired** - Scheduled date for automatic deletion
* **Date Created** - Date the backup was created

![](https://3607108856-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LHVg57XIRcjV-Vbubtn%2Fuploads%2Fgit-blob-4b764ceebcb85ca79135de40933a1a37c981f409%2Fbackup-detail.png?alt=media)

## Creating a Backup

Only administrators can create backups.

To create a new backup:

1. Go to **Settings > Backups**
2. Click the **+ Add Backup** button
3. A form will appear showing the **cost** of the backup
4. Fill in the **Name** and **Description**
5. Click **Submit**
6. You’ll receive an **email notification** once the backup is ready. Depending on your data size, it may take several minutes to hours.
7. Open the email and click **Download** to access your backup

![](https://3607108856-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LHVg57XIRcjV-Vbubtn%2Fuploads%2Fgit-blob-b1df34059bf777cc63e05f65adbdb7e4714b1084%2Fbackup-add.png?alt=media)

## Deleting a Backup

Backups can be deleted from either the list or detail views.

* **From List View**: Click the **Delete** icon next to the backup entry.
* **From Detail View**: Open the backup and click the **Delete** button.

## Backup File Structure

Once you download and unzip the backup, the folder structure will look like this:

```
+ Folder (Organization sid)
    + versions
        + ... list of versions in JSON
    + ... list of files
```

* Files are stored using their UID and original file name
* Versions are stored as individual JSON files

{% hint style="info" %}
Use the export function to match the files and versions with each record.
{% endhint %}