# Migration Tools

### Database Backup Tool

To access the tool, please navigate to the user dropdown and select **Backup Tools > Database**.

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-8875d9e589d227c7373eb8e9910df518948eb322%2FXnapper-2024-11-13-20.47.25.png?alt=media" alt=""><figcaption><p>Access Database backup tool</p></figcaption></figure>

#### Create Backup

The backup tool shows your current database size and, if you have SERP HTML snapshots, the number of files and their total size.

**SERP HTML Snapshots** are the actual Google search result pages captured during rank tracking. These files are stored separately on disk (not in the database). If you want to view SERP snapshots after restoring a backup, you must include them in the backup.

You can toggle **"Include SERP HTML snapshots in backup"** to choose whether to include these files:

* **Enabled (default)**: Creates a full backup (`.tar.gz`) containing both the database and HTML snapshots
* **Disabled**: Creates a database-only backup (`.db.gz`) without HTML snapshots

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-ffa72744d79988ecb1cc496de3d9281ad7b54723%2FXnapper-2025-12-01-21.06.22.png?alt=media" alt=""><figcaption></figcaption></figure>

Simply click the **Create Backup** button, and select a folder to save the backup file.

There are some **important** things you need to note.

{% hint style="warning" %}

1. You won't be able to use the app while the backup is being created, and all background jobs will be paused.
2. Please ensure that no reports are running before starting the backup to avoid data corruption.
   {% endhint %}

The process will take 1 to 15 minutes, depending on the size of your database. Once the backup is complete, you can click "Back to Database Backup" to return to the previous page.

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-a8e06e2506f43c927b2f46aa4f0568c46966ff0a%2FXnapper-2024-11-13-20.54.41.png?alt=media" alt=""><figcaption><p>Create backup process is completed!</p></figcaption></figure>

### Restore Backup

You can restore a backup on your current device or a different one. **Please note:**

{% hint style="warning" %}

1. The version of SEO Utils on the device you're restoring to must match the version used to create the backup file.
2. Restoring a database will overwrite all current data on the device.
   {% endhint %}

Please select a backup file and click the "Import Database" button. The tool supports both backup formats:

* **Full backup** (`.tar.gz`): Contains database and SERP HTML snapshots
* **Database-only backup** (`.db.gz`): Contains only the database (legacy format)

After selecting a file, the tool displays the **Backup Contents** showing:

* Database size
* Number of SERP HTML snapshot files and their total size (if included)
* For legacy backups, it indicates that SERP HTML snapshots are not included

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-bc273da8fb170026e7a49423c0c9ade17e1e42d9%2FXnapper-2025-12-01-21.33.51.png?alt=media" alt=""><figcaption><p>Restore a backup file</p></figcaption></figure>

After the restore process is complete, please restart the app to apply the changes.

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-75ea63786504c9a2b5f06aa7bd0b6b27024ea6f5%2FXnapper-2024-11-13-21.02.24.png?alt=media" alt=""><figcaption><p>The restore process is complete.</p></figcaption></figure>

### App Configurations Backup Tool

In addition to the database, consider backing up your app configurations to save time on re-setting important settings like the [DataForSEO API](https://help.seoutils.app/seo-data-source#how-to-connect-your-dataforseo-account-to-seo-utils), [Renting API Key](https://help.seoutils.app/guide/rent-dataforseo-api-key), [Google Maps API](https://help.seoutils.app/google-my-business-rank-tracker#setup-the-google-places-api), [IndexNow API](https://help.seoutils.app/guide/indexnow), and others.

To access the tool, please navigate to the user dropdown and select **Backup Tools > App Configurations**.

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-ef99527a2823ab8c91662ac70bcbc06e117e44f4%2FXnapper-2024-11-13-21.07.01.png?alt=media" alt=""><figcaption><p>Access the app configurations backup tool</p></figcaption></figure>

Just like the database backup tool, you’ll be able to create and restore a backup file for your app configuration.

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-140764d912c293482756fc3ae9f14139d2c8c2b1%2FXnapper-2024-11-13-21.08.09.png?alt=media" alt=""><figcaption><p>Create &#x26; restore app confugrations</p></figcaption></figure>

### Cloud Database

This feature is coming in January 2025.