# Move data to another drive

Source: https://frameleaf.app/docs/admin/move-data-to-another-drive/

Your library keeps three things that can each live on a different drive: your photos and videos, the database, and thumbnails. You can move any of them later from Frameleaf Manager's **Storage** page. Manager copies and checks everything before it switches, and keeps the original.

The most common reason to move is speed. Photos and videos are fine on big hard drives, but the database and thumbnails are read all the time, so an SSD or NVMe drive makes browsing, search and scrolling faster. See [Fast drives for the database and thumbnails](https://frameleaf.app/docs/start/requirements/#fast-drives-for-the-database-and-thumbnails).

## The Storage page

In Manager, open **Storage**. **Drives** at the top shows each drive, how full it is and which parts of your library are on it, such as **Photos and videos 1.8 TB · Thumbnails 86 GB · Backups**. Below that, it shows where your library keeps its data:

- **Photos and videos**: the folder, its drive, and how much they use.
- **Database**: the folder, its drive, and how much it uses.
- **Thumbnails**: either **with your photos and videos**, or a folder of their own with its drive.

Under each folder, Manager shows the drive it's on and how much room is left, such as **Cache pool (NVMe SSD) · 180 GB free**. A drive that's running out of room is marked **Nearly full**.

**Also on this server** lists what else Frameleaf keeps: the [backups](https://frameleaf.app/docs/admin/backup-and-restore/#back-up-with-manager) folder, the downloaded machine learning models, and the extra folders added on [Containers](https://frameleaf.app/docs/admin/manager/#folders).

### Suggestions

While the database is on hard drives, or thumbnails are with your photos, Manager looks for a faster drive with room. When it finds one, it shows a suggestion such as **Suggested: Cache pool (NVMe SSD)**, with the reason, and a **Move to** button with the drive's name. It prefers NVMe, then the fast drive with the most free space, and only suggests a drive that holds one and a half times what's needed. When the database and thumbnails would both use the same fast drive, the database comes first.

When a fast drive is too full, or there's no fast drive at all, Manager says so instead. See [How Manager suggests a drive](https://frameleaf.app/docs/start/install/#how-manager-suggests-a-drive).

### Make another drive available first

Manager can only move to a drive it can see.

- **Unraid and TrueNAS:** Manager already sees your shares, pools and drives under `/mnt`. **Move…** opens a folder picker.
- **Plain Docker:** start Manager with the other drive in `MANAGER_EXTRA_FOLDERS`. See [Add more drives](https://frameleaf.app/docs/start/install/#add-more-drives).
- **Other installs:** **Move…** lists the folders mounted into Manager. If it says **No other drive is mounted into Manager. Add one to Manager's folders first.**, add the drive to Manager's container, then come back.

Thumbnails and the database need a drive inside this server, not a network share, and a folder of their own, separate from your photos, your backups and Manager's own settings.

## Move the database

1. On **Storage**, select **Move to** on the suggestion, or **Move…** (**Choose another folder…** when there's a suggestion) beside **Database**.
2. Choose a folder for the database. Manager creates a `frameleaf-databases` folder inside it and shows the new folder and its drive.
3. Manager checks the folder and shows how much it will copy. The drive needs room for twice the database: the copy, and a second copy a later update may need.
4. Select **Move the database**.

Frameleaf is unavailable until the move finishes. Manager saves a recovery point, copies the database into the new folder and checks it, then starts Frameleaf on it. The current folder is kept, and if anything fails Frameleaf goes back to it, with nothing lost.

Once Frameleaf has started on the new folder, it may have saved changes there, so going back to the original folder isn't offered. If the move stops at that point, choose **Resume safely** to finish it.

If Manager says **The database engine differs from the installed release's**, update Frameleaf first, then move the database.

## Move thumbnails

1. On **Storage**, select **Move to** on the suggestion, or **Move…** (**Choose another folder…** when there's a suggestion) beside **Thumbnails**.
2. Choose a folder for thumbnails. Manager creates a `frameleaf-thumbnails` folder inside it and shows the new folder and its drive.
3. Manager counts the thumbnails and shows how many files and how much it will copy.
4. Select **Move thumbnails**.

Frameleaf is unavailable until the copy finishes. The steps are **Pause uploads and background work**, **Copy thumbnails**, **Check every file**, **Switch to the new folder** and **Start Frameleaf**. Manager checks every copy before it switches, and your photos and the database aren't touched. The original thumbnails are kept.

If Manager says **This server can't yet confirm that uploads and background work have stopped, so moving isn't available.**, nothing was stopped or moved. Try again once Frameleaf has finished what it's doing.

## Move photos and videos

1. On **Storage**, select **Move…** beside **Photos and videos**.
2. Under **Choose a bigger drive**, pick a folder. Manager creates a `frameleaf-photos` folder inside it and shows how much it will copy.
3. Tick the box to confirm you have a separate backup of your photos and videos.
4. Select **Move the library**.

Frameleaf is unavailable while the move runs. Uploads and background work stop first, and a verified database recovery point is saved. Manager copies and checks every file, then switches the folder. Thumbnails on a drive of their own stay where they are.

The original copy is kept and shown on the **Storage** page as **Retained original copy**. New writes go to the new folder, so don't switch back to the old copy without another verified move or a complete restore.

## Stop, resume or cancel a move

While Manager moves thumbnails or photos, the progress screen offers **Stop safely**, which stops the move at a safe point.

If a move stops or fails, choose **Resume safely** to pick up where it left off, or **Cancel safely** to go back to the original folder. Until Frameleaf starts on the new folder, a stopped move always goes back to the original one. Manager doesn't delete the original folder or a partial copy, so you can check both before removing anything yourself.

## If the thumbnail drive goes missing

When thumbnails are on a drive of their own and that drive is unplugged, not mounted or failed, the **Storage** page shows **The thumbnail drive isn't connected**. Frameleaf can't start without it, but your photos are safe.

You have two choices:

- **Connect the drive and check again.** Plug it back in or mount it at the same place, then select **Check again**. On Unraid, check **Main** for the pool or Unassigned Devices drive. On TrueNAS, check **Storage** for the pool.
- **Put thumbnails back with your photos.** Select **Put back with your photos…**, read the review, which says how many thumbnails Frameleaf will make again, then select **Put back and rebuild**.

Putting them back takes three steps: **Switch to your photos folder**, **Start Frameleaf** and **Queue new thumbnails**. Frameleaf starts straight away and makes new thumbnails in the background. On a large library this can take many hours. Your photos and videos are not touched, and the old drive isn't used again.

This only goes forward. If it stops part way, choose **Resume safely** to finish it. If the drive comes back before Manager switches, it stops with nothing changed and says **The thumbnail drive is connected again. Check again to use it.**

:::tip
The thumbnails folder also holds edited versions. If you back it up with your photos, you can restore that backup onto a new drive mounted at the same place and select **Check again**, so nothing has to be made again.
:::

### Restore when the thumbnail drive is gone

When you [restore a database backup](https://frameleaf.app/docs/admin/backup-and-restore/), Manager keeps thumbnails where they are now. If their folder is gone, **Check this server** shows **The thumbnails drive isn't connected** and offers **Keep thumbnails with your photos**. The restore review then says **Thumbnails go back in the photos folder**, and any missing thumbnails are made again. Your photos are untouched.

## Low space warnings

Each drive your library uses is watched on its own. Frameleaf warns you when a thumbnails drive of its own is nearly full, and when it's almost out of space new thumbnails wait until there is room. See [A drive is nearly full](https://frameleaf.app/docs/help/troubleshooting/#a-drive-is-nearly-full).
