Skip to content

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.

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 folder, the downloaded machine learning models, and the extra folders added on Containers.

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.

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.
  • 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.

  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.

  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.

  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.

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.

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.

When you restore a database backup, 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.

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.