How to Turn Existing NAS Folders Into a Searchable Photo Library Without Moving Your Originals

Eva Wong is the Technical Writer and resident tinkerer at ZimaSpace. A lifelong geek with a passion for homelabs and open-source software, she specializes in translating complex technical concepts into accessible, hands-on guides. Eva believes that self-hosting should be fun, not intimidating. Through her tutorials, she empowers the community to demystify hardware setups, from building their first NAS to mastering Docker containers.

You can make years of NAS photos easier to search without moving them into a new folder structure or copying the entire archive into another application. The key is to choose a photo manager that indexes existing directories, reads their metadata, and builds a searchable interface around the files you already have.

This guide covers three approaches: ZimaOS Photos for built-in folder indexing, Immich for external libraries, and PhotoPrism for indexing existing originals. Each has a different setup process, but the goal is the same: preserve your source files while making them easier to browse by date, location, metadata, and, where supported, image content.

How Does Indexing Existing NAS Folders Work?

Your NAS folders remain the storage location. The photo application scans selected directories and creates an index that helps it display photos in a timeline, map, gallery, or search results.

Component Purpose What to Know
Original files Store your photos and videos Remain in their existing folders when using an index-in-place workflow.
Metadata index Organize photos by date, location, camera details, and other attributes May be stored in the application's database rather than written back to the files.
Thumbnails and previews Make large libraries faster to browse Require additional storage even when the originals are not copied.
AI indexing Support features such as semantic search or scene recognition Availability and hardware requirements depend on the application.

This approach combines the portability of normal folders with a richer browsing experience. For a deeper explanation of the trade-offs, see photo libraries vs NAS folders.

Before You Start: Protect Your Existing Archive

1. Identify the Source Folders

Choose the directories that contain your actual photo and video collection. For example, you might have separate folders for phone backups, camera originals, family photos, and scanned prints.

Use the real paths on your NAS rather than assuming every system stores files in the same location. Avoid indexing application databases, thumbnail caches, temporary exports, or unrelated directories.

2. Back Up the Originals

Indexing is not a backup. Before connecting a new application to an important archive, make sure you have an independent copy of the original files. Read-only access can reduce the risk of changes through the application, but it cannot protect against drive failure or deletion by another process.

3. Decide Whether Read-Only Access Is Enough

If you only need to browse and search, read-only access is a sensible starting point. Some applications store albums, descriptions, or other changes in their own database; others may support sidecar files or write operations when permissions allow them.

Check the application's metadata behavior before choosing a permission model. Keeping the originals untouched may mean that changes made inside the photo application are stored separately.

4. Allow Space for Indexing

The originals may stay in place, but thumbnails, databases, caches, and AI-related data can still consume storage. Large RAW and video collections may also take considerable time to scan.

Choose an Indexing Method

Method Best For Main Requirement
ZimaOS Photos Users running ZimaOS Add existing folders as photo sources.
Immich external library Users who want Immich's self-hosted photo interface Mount the source directory into the Immich container and scan it.
PhotoPrism originals indexing Users who want a metadata-focused photo catalog Configure the originals directory and run indexing.

Method 1: Index Existing Folders With ZimaOS Photos

ZimaOS Photos is designed to build a unified photo library from folders already stored on your server. It indexes selected sources without moving or copying the original files, then makes the collection available through views such as the photo wall, timeline, map, and collections.

If you want a searchable photo library without setting up a separate photo-management stack, this is the most direct route when your server runs ZimaOS.

Setup Steps

  1. Open Photos on your ZimaOS device.
  2. Click the settings button in the top-left corner.
  3. Add the existing folder you want to index as a source.
  4. Let ZimaOS scan the folder and build the library.
  5. Check the timeline, metadata, and search results against a few files you already know.

Photos is available starting with ZimaOS 1.8. Its current documentation lists support for common formats, many camera RAW formats, and video metadata. Some files may be indexed even when thumbnail generation depends on the format or embedded preview.

After indexing, the originals remain in their existing NAS folders. Photos adds a visual interface and local AI search, while the filesystem remains available for normal file access and independent backup.

For current setup details and format limitations, consult the ZimaOS Photos documentation.

Best for: ZimaOS users who want to browse and search an existing archive without manually configuring container paths.

Method 2: Add Existing Folders to Immich as an External Library

Immich supports external libraries for photos and videos stored outside its normal managed upload location. After the directory is mounted and scanned, the media appears in the main timeline and can be used with supported library features.

This is useful if your NAS already has a folder structure you want to preserve. However, an external library is a distinct workflow from uploading files into Immich's managed storage.

Step 1: Mount the Source Directory

For a Docker-based installation, add a volume mapping to the immich-server service in your existing Compose configuration. For example:

services:
  immich-server:
    volumes:
      - /mnt/storage/Photos:/mnt/storage/Photos:ro

This is an illustrative mapping, not a complete Compose file. Replace the host path with your actual photo directory and merge the entry into your existing configuration rather than replacing the whole file. The example uses the same path inside and outside the container, which makes the path easier to identify when configuring the library.

The :ro suffix mounts the source as read-only. Apply the updated configuration using the procedure for your installation, then confirm that the directory is visible to the Immich server container.

Step 2: Create and Scan the External Library

  1. Sign in to Immich with an administrator account.
  2. Open the Administration area and select External Libraries.
  3. Create a library and choose the user who will own it.
  4. Add the source path as it appears inside the container.
  5. Start a library scan.
  6. Check the Jobs page to confirm that scanning, thumbnail generation, and metadata extraction are progressing.

Follow the current Immich external library guide for version-specific instructions.

Step 3: Understand External-Library Limitations

Immich currently assigns each external library to a single user. Metadata added inside Immich, such as descriptions or album membership, is stored in its database rather than written back to the original media files.

Also consider what happens when a source file is deleted or moved. Immich must rescan the library to detect filesystem changes; a missing external asset can be moved to Immich's trash during a rescan. Keep the source archive backed up and test the workflow before relying on it for a large collection.

Best for: users who want Immich's timeline, maps, albums, and search while keeping an existing directory tree outside its managed upload storage.

Method 3: Index Existing Originals With PhotoPrism

PhotoPrism can index an existing originals directory without renaming or moving the source media. It reads metadata and builds the index and previews needed for browsing and search.

Step 1: Configure the Originals Directory

In a Docker deployment, a volume mapping might look like this:

volumes:
  - "/mnt/storage/Photos:/photoprism/originals:ro"
  - "/mnt/storage/PhotoPrismData:/photoprism/storage"

These are example paths. Adapt them to your deployment and keep the application storage directory writable while mounting the originals read-only if you do not want PhotoPrism writing to the source folder.

Step 2: Run Indexing

  1. Start PhotoPrism with the correct volume configuration.
  2. Confirm that the originals directory is accessible.
  3. Open Library in the web interface.
  4. Select a subfolder or the full originals directory.
  5. Start indexing and wait for the scan to finish.
  6. Search for several known images and check their dates, filenames, and metadata.

PhotoPrism distinguishes indexing from importing. Indexing existing originals preserves their filenames and folder structure. Importing, by contrast, can copy or move files into the originals directory and organize them under new names and paths.

For an established NAS archive, read the official PhotoPrism library indexing guide before selecting an import workflow.

Best for: users who want a searchable photo catalog while keeping an existing photography archive in place.

How to Verify That Your Originals Have Not Moved

Once the first scan is complete, verify the source files independently of the photo application's interface.

  1. Check the source folders. Confirm that original files remain in their expected locations.
  2. Compare sample filenames. Choose files from different folders and verify their names and paths.
  3. Check file counts. Compare a representative source folder before and after indexing. If the app shows fewer items, investigate unsupported formats, exclusions, unreadable files, or incomplete jobs.
  4. Inspect application storage. Confirm that databases, thumbnails, and caches are being written to the intended location.
  5. Open the files outside the photo app. Use your normal NAS file-sharing workflow to confirm that the archive remains accessible.

Common Problems and Fixes

Problem Likely Cause What to Check
The library is empty Incorrect path or missing permissions Verify the path from inside the application or container and confirm read access.
Some photos are missing Unsupported formats, exclusions, or an incomplete scan Review logs, supported formats, and indexing jobs.
New files do not appear The index has not refreshed Run a supported scan or configure a refresh schedule.
Dates or locations look wrong Missing or inconsistent metadata Inspect the original file metadata and the application's date-handling settings.
Albums or descriptions disappear after a restore Application metadata was stored separately from the originals Restore the database and configuration alongside the media when required.

Keep the Library Searchable After a Restore

Preserving the original files is only part of a reliable setup. Depending on the application, albums, descriptions, user settings, and search-related data may live in a database or application directory.

Back up the original media and the application state needed to rebuild the library. For a practical recovery checklist, see what to restore for a searchable photo library. Immich users should also plan for both media files and the database, as explained in the Immich photo backup guide.

Do not assume that copying the photo directory alone will preserve every album, edit, or search feature. Test the recovery process before the archive becomes dependent on the new application.

Frequently Asked Questions

Can I make NAS photos searchable without importing them?

Yes, provided the application supports indexing existing folders or external libraries. ZimaOS Photos indexes selected sources in place, while Immich and PhotoPrism offer documented workflows for existing media. Confirm the storage model before starting.

Will indexing change my filenames or folder structure?

Not when you use an index-in-place workflow as intended. PhotoPrism's originals indexing preserves filenames and folders, and ZimaOS Photos scans selected folders without moving or copying the source files. Importing files into an application-managed library can behave differently.

Can I search by what appears in a photo?

Some platforms support AI-powered semantic search, face recognition, or scene detection; others focus on filenames and metadata. Check which features your chosen application provides and whether they run locally or require additional services.

Does a searchable photo library replace my backup?

No. Keep an independent copy of the original media and back up application data that contains albums, descriptions, user settings, or other information you want to preserve. Test restoration instead of assuming that a successful file copy means the whole library has been recovered.

Final Verdict

You do not need to reorganize an established NAS archive to make it easier to explore. Choose an application that supports indexing existing folders, start with a small test directory, verify that the originals remain unchanged, and confirm how the application stores metadata.

ZimaOS Photos offers the simplest integrated approach for ZimaOS users. Immich external libraries and PhotoPrism originals indexing are alternatives for users who prefer a separate self-hosted photo application. In every case, protect the original files and the application data needed to recover the library.

Support & Tips

More to Read

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.