# Switch from Noodle Gallery

Source: https://frameleaf.app/docs/migrate/from-noodle-gallery/

Noodle Gallery is built on Immich, so Frameleaf Manager imports it the same way: a guided, one-time import into a new Frameleaf database, with your photos and videos left where they are. Your Gallery database and media aren't changed.

Gallery adds its own features on top of the shared library, such as Spaces and pets. Those don't come across yet. Check [what stays behind](#what-stays-behind) before you switch.

:::caution[Frameleaf mobile apps are required]
**The Noodle Gallery mobile apps do not work with Frameleaf.** Use Frameleaf's native [iOS app](https://frameleaf.app/apps/iphone/) or [Android app](https://frameleaf.app/apps/android/), and connect it to your server after the import.
:::

## Which Gallery versions work

Manager finds your Gallery server from its `open-noodle/gallery-server` container and shows it as **Noodle Gallery** with Gallery's own version number, such as 5.9.0.

Gallery's version number doesn't decide whether you can import. Manager reads which Immich release your Gallery library is built on, and that needs to be Immich 2.0 or later. Every current Gallery release qualifies.

If Manager says it can't read your library, update Noodle Gallery to its latest release, let it start once, and try again.

## Import with Frameleaf Manager

The steps are the same as [Switch from Immich](https://frameleaf.app/docs/migrate/from-immich/#import-with-frameleaf-manager):

1. [Install Frameleaf Manager](https://frameleaf.app/docs/start/install/) on the host running Noodle Gallery.
2. On **Choose how to begin**, select **Review import**. If Manager hasn't found Gallery yet, select **Find installations**. Pick the installation marked **Noodle Gallery** and select **Review library & settings**.
3. Review the media mappings and settings. Manager shows **Some Noodle Gallery features stay behind** here, before anything changes.
4. Let Manager back up the Gallery database, select **Check this server**, then **Review the switch** and **Start import**.

Before you start, make your own backup of the Gallery database and all media, plan some downtime, and pause phone uploads. [Before you start](https://frameleaf.app/docs/migrate/from-immich/#before-you-start) on the Immich page has the full checklist.

## What comes across

Everything Gallery shares with Immich comes across, just as it would from Immich:

- accounts, photo and video records, ownership and access controls
- albums, album owners, shared members and the photos in each album
- tags, memories, people and faces
- share links and partner sharing
- descriptions, ratings, edits and Live Photos
- each owner's favourites on their own photos

Locked, hidden and deleted items keep their state. Frameleaf then builds fresh thumbnails, search and face data in the background.

## What stays behind

These Gallery features don't come across. Manager lists them in the import review before anything changes, and after the import each administrator gets a notification naming the ones your library used. Make a note of anything you rely on before you switch.

| Gallery feature | What happens in Frameleaf |
| --- | --- |
| **Spaces** | Spaces, their members and roles, the photos, albums and libraries added to them, Space activity and Space folders don't come across. The photos and albums themselves do, with their owners. To share them again, use [shared albums](https://frameleaf.app/docs/using/sharing/) or partner sharing. |
| **People in Spaces** | People named inside a Space, and their aliases, don't come across. Each owner's own people and faces do. |
| **People shared between accounts** | People shared from one account to another don't come across, the same as for Immich 3.3 and later. |
| **Pets** | Pet names and species don't come across. |
| **Favourites set by other people** | A favourite someone set on a photo shared with them doesn't come across. The photo owner's favourites do. |
| **User groups** | User groups and their members don't come across. Invite or share with each account directly. |
| **Gallery-only edits** | Exposure, contrast, saturation and invert adjustments, and video trims, don't come across. Your originals and edits made with the shared editor do. |
| **Auto-classification and clean-up** | Gallery's classification categories, photo quality scores and clean-up review decisions don't come across. |
| **Face repair** | Face repair scans and declined suggestions don't come across. Frameleaf rebuilds face data with its own processing. |

As with Immich, sessions and API keys start fresh, so you'll sign in again and reconnect your apps. Workflows, plugin credentials, job history and notification history stay behind too.

## Finish and check your library

Follow [Finish and check your library](https://frameleaf.app/docs/migrate/from-immich/#finish-and-check-your-library). Sign in with your Gallery administrator's email and password when Frameleaf asks. Frameleaf opens straight away and shows the rest of the work in the [**Setting up your library** bar](https://frameleaf.app/docs/migrate/from-immich/#while-frameleaf-sets-up-your-library).

Then check the shared photos that matter to you. Anything that was shared only through a Space needs to be shared again.

## If the import stops or you need to go back

Read the recorded failure, fix its cause and choose **Resume safely**. Keep Manager's own folder, both database folders and the media locations as they are, and resume the same import instead of starting a second one.

Manager only reads the Gallery database and never changes it. Once Frameleaf has written to your media, though, restarting Gallery against those same files won't roll it back. To go back, recover Gallery from its own database backup and a matching media backup.
