# Try Frameleaf without moving your photos

Source: https://frameleaf.app/docs/migrate/try-without-moving-your-photos/

Already keep your photos in another app, or in folders you look after yourself? You can try Frameleaf on them without moving anything. Frameleaf reads the folder where it is, read-only, while your other app carries on as before. Nothing is moved, copied, renamed or deleted, and you can stop whenever you like.

This guide sets up a new library with Frameleaf Manager on Linux, [Unraid](https://frameleaf.app/docs/nas/unraid/) or [TrueNAS](https://frameleaf.app/docs/nas/truenas/), then adds your folder.

## How your photos stay safe

Two settings work together, and this guide turns on both:

- **Manager gives Frameleaf the folder read-only.** Frameleaf can look at the files but can't change them.
- **Frameleaf keeps the folder read-only too.** Albums, descriptions, dates, ratings and other edits are saved in Frameleaf's own storage, never beside your originals.

Frameleaf still needs folders of its own, which Manager creates during setup. Here's what lives where:

- **In your folder:** your original photos and videos, and any sidecar files your other app writes. They stay untouched.
- **In Frameleaf's folders:** thumbnails and video previews, albums, people, descriptions and other edits, photos uploaded from the Frameleaf app, and the database and its backups.

## Before you start

- **Find your folder's path on the server**, such as `/mnt/user/photos` on Unraid, `/mnt/tank/photos` on TrueNAS or `/media/disk2/Photos` on Linux. Use the real folder, not a link (symlink) to it. Its name can't contain a comma or colon.
- **Choose the folder of originals only.** If your other app keeps its own previews in the same place, pick the folder of originals inside it, or Frameleaf shows those previews as photos too. For an Immich library, that's the `library` or `upload` folder inside Immich's upload location, not `thumbs` or `encoded-video`.
- **Leave room for Frameleaf's own files**, mostly thumbnails and video previews, on a drive with space to spare.

## 1. Let Manager see the folder

**On Unraid and TrueNAS, there's nothing to do.** Manager can already see every folder under `/mnt`. Skip to [step 2](#2-set-up-frameleaf-in-manager).

**On Linux**, Manager can see its parent folder (`/srv/frameleaf` unless you chose another) and any drives you list in `MANAGER_EXTRA_FOLDERS`. If your photos are somewhere else, list the folder that *holds* your photo folder. For photos in `/media/disk2/Photos`, list `/media/disk2`:

```sh
MANAGER_EXTRA_FOLDERS=/media/disk2 sh launch.sh \
  ghcr.io/frameleaf/frameleaf-manager:latest \
  'https://server.example:2282' \
  /srv/frameleaf \
  '<server-lan-ip>'
```

For photos in `/home/sam/Pictures`, list `/home/sam`. Each folder you list must already exist and be at least two levels deep. To list several, separate them with colons. See [Add more drives](https://frameleaf.app/docs/start/install/#add-more-drives).

Is Manager already running? Remove its container with `docker rm --force frameleaf-manager`, then run the launcher again with the same arguments and `MANAGER_EXTRA_FOLDERS`. Manager's settings stay in the parent folder, and your photo library keeps running while Manager restarts.

:::note[Other ways of installing]
If you started Manager with the long form that names every folder, **External folders** isn't offered. Add the folder for the server on Manager's [Containers](https://frameleaf.app/docs/admin/manager/#folders) page instead: choose **Add a folder…**, pick the folder, set **Inside Frameleaf** to the same path, such as `/media/disk2/Photos`, and leave **Read-only** on. During setup, use **Advanced container settings**, as `/media/disk2/Photos:/media/disk2/Photos:ro`. Follow what Manager tells you if it refuses the folder. If you run Docker Compose yourself, mount the folder with `:ro` as in [Folders of photos](https://frameleaf.app/docs/admin/external-libraries/#1-let-frameleaf-see-the-folder), then skip to [step 4](#4-add-the-folder-in-frameleaf).
:::

## 2. Set up Frameleaf in Manager

Follow [Install with Frameleaf Manager](https://frameleaf.app/docs/start/install/) up to **Choose how to begin**, then:

1. Under **Set up a new library**, select **Set up Frameleaf**. If Manager also offers **Review import** for an Immich installation, or lists your app under **Import from another photo app**, leave it for now: an import brings the whole library into Frameleaf, and an Immich import keeps Immich stopped afterwards.
2. For **Photos and videos**, keep the new folder Manager suggests. This is Frameleaf's own folder, for thumbnails and phone uploads. Don't choose your photo folder here.
3. Keep or change the **Database**, **Thumbnails** and **Backups** folders as you like.
4. Under **External folders**, select **Add a folder…**. Open your photo folder and select **Use this folder**. It's added with **Read-only** ticked. Leave it ticked. Add more folders the same way.
5. Select **Check this server**. If another app already uses port `2283`, select **Use port 2284**. Then select **Review installation** and **Install Frameleaf**.

Manager won't add a folder that holds Frameleaf's own data or sits inside it, or one at the top of a drive, pool or share list, such as `/mnt/user`. It tells you why and you can choose another.

### Already installed Frameleaf?

Open **Services** in Manager. Under **External folders**, select **Add a folder…**, choose the folder, then select **Save and restart Frameleaf**. Photo access pauses for about a minute while Frameleaf restarts.

## 3. Finish setup

Carry on with **Make it yours** to create your photo account and get the app, as in [Install with Frameleaf Manager](https://frameleaf.app/docs/start/install/#5-finish-your-photo-account-and-phone-setup). Anything you upload from your phone goes into Frameleaf's own **Photos and videos** folder, never into your photo folder.

## 4. Add the folder in Frameleaf

Sign in to Frameleaf as the administrator. Open **Settings**, then **Libraries**, and select **Add a folder of photos**.

1. Select **Choose folder…**, open the same folder you added in Manager, and select **Use this folder**. Frameleaf sees it at the same path as the server does, such as `/media/disk2/Photos`. Give it a **Library name**. Only folders connected to Frameleaf are listed. If you see **Frameleaf can’t see any folders here yet**, or **This folder isn’t connected to Frameleaf yet**, go back to [step 2](#already-installed-frameleaf) and add the folder in Manager, then choose it again.
2. Under **Show these photos in**, choose your own account.
3. Leave both choices under **What to skip** ticked. If your other app keeps exports or previews inside the folder, skip them with a pattern such as `**/Exports/**`.
4. Leave **Keep source files read-only** on. You can't change it after the folder is added.
5. Leave **Look for photos as soon as I add it** on, and select **Add folder**.

The first check starts by itself, and you can follow it on the **Libraries** page. After that, Frameleaf builds thumbnails, faces and search in the background. On a big library this takes a while; follow it in **Activity**.

For every option on this page, see [Folders of photos](https://frameleaf.app/docs/admin/external-libraries/).

## Using Frameleaf alongside your other app

- **Keep managing your photos the way you do now.** Frameleaf finds new, changed and removed files when it checks the folder: every night, or when you select **Check now** in **Libraries**. For a folder on this server's own disks, turn on **Notice new files right away** and new photos appear within a minute.
- **Moving or renaming a file is a new photo to Frameleaf.** Albums, descriptions and other details you added in Frameleaf stay with the old one and are lost. Try Frameleaf's albums on photos you aren't about to reorganise.
- **Albums and people from your other app don't come across.** Frameleaf reads what's in the files: dates, places, camera details, and the descriptions, ratings and tags in any `.xmp` sidecars beside them. To bring a whole library across with its albums, see [Bring an existing library](https://frameleaf.app/docs/migrate/from-another-library/), [Switch from Immich](https://frameleaf.app/docs/migrate/from-immich/) or [Switch from another photo app](https://frameleaf.app/docs/migrate/from-other-photo-apps/).
- **Browse it like your folders.** Turn on folder view in **Settings**, then **Your preferences**, then **Tools & sidebar**, with **Use** in the **Folders** row.

## What Frameleaf never does to your folder

- **It never deletes a file there**, not even when you empty the Trash. Deleting a photo in Frameleaf only removes it from Frameleaf. The file is still in your folder, so the next check brings it back. To keep a photo out of sight, archive it instead.
- **It never writes your edits there.** They're kept in Frameleaf. Sidecars your other app wrote are still read; Frameleaf edits a copy of its own.
- **It never moves or renames files there.** The [storage template](https://frameleaf.app/docs/admin/storage-template/) and [physical deduplication](https://frameleaf.app/docs/admin/physical-deduplication/) leave these folders alone.
- **It doesn't panic when the folder goes away.** If a file disappears, its photo waits in the Trash and comes back when the file returns. If a NAS is off and the folder looks empty, nothing is marked missing.

Frameleaf's backups cover its database and its own files, not your folder. Keep backing up your photos the way you do now.

## Stop the trial

To take the photos out of Frameleaf, open **Settings**, then **Libraries**, select the folder, then **Remove N photos from Frameleaf**. Select **Remove library**, then type the library name to confirm. The files stay exactly where they are.

To remove Frameleaf from the server too:

1. In Manager, open **Services** and note the name after **Frameleaf ·**, such as `frameleaf-1a2b3c4d5e6f`. Select **Stop stack**.
2. Remove the library's containers, using that name:

   ```sh
   docker compose -p frameleaf-1a2b3c4d5e6f down
   ```

3. Remove Manager: on Unraid from the **Docker** tab, on TrueNAS from **Apps**, or on Linux with `docker rm --force frameleaf-manager`.
4. Delete the folders you chose for Frameleaf in step 2: **Photos and videos**, **Database**, **Thumbnails** if it had its own, **Backups**, and the `manager` folder Manager kept its settings in. Don't delete a whole drive or parent folder, in case your photo folder is inside it.

Decided to stay? Leave everything as it is. Your folder keeps working this way for good, and you can bring a whole library across later.

## If a check finds nothing

Make sure that:

- the folder is listed under **External folders** in Manager's **Services** page
- you chose the same path in Frameleaf as in Manager
- Frameleaf is allowed to read the files in the folder

For more checks, see [If a check finds nothing](https://frameleaf.app/docs/admin/external-libraries/#if-a-check-finds-nothing).
