Halloween DealsAmazon USHalloween week deals: useful picks before month-endAmazon US: current deals, useful picks and tech finds.Check DealsSlow PC?RecommendedPC slow today? Run a repair scan before it gets worseResolve common Windows issues and optimize system performance.Scan NowHalloween DealsAmazon USOctober picks are moving - compare before checkoutAmazon US: current deals, useful picks and tech finds.See Picks×
FREEDOM251

Freedom251 › Blog › Google Photos

How to Move Your Photo Library from Google Photos to a Self-Hosted Gallery

By Freedom251 Team · · 10 min read

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

The most documented path is to export Google Photos with Google Takeout, then import the archive into Immich with the Takeout-aware immich-go workflow. Keep the archive and its JSON sidecars, give Immich enough storage for both the imported library and backups, and treat album and metadata matching as something to verify rather than assume.

This guide covers the migration sequence, what transfers, the limits of external libraries, and a backup plan that can recover both your media files and Immich’s database metadata.

As an Amazon Associate I earn from qualifying purchases.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

What you need before starting

A migration is safer when the source export, destination library, and recovery copies are planned together. Immich’s Quick Start tells administrators to set an UPLOAD_LOCATION on a disk with enough free space. For this project, “enough” means space for all of the following at the same time:

  • The downloaded Google Takeout archive or archives.
  • The extracted media and JSON files while the import is being processed.
  • The Immich destination library if you use the normal upload workflow.
  • At least one separate filesystem copy for recovery.

Estimate from your own collection rather than from a generic photo count. Videos, edited exports, and duplicate files can make the archive substantially larger than the number of visible items in Google Photos. Do not delete the Takeout files until you have checked the imported counts, dates, locations, descriptions, and important albums.

#1 Best Overall
Sale
WD 2TB Elements Portable External Hard Drive for Windows, USB 3.2 Gen 1/USB 3.0 for PC & Mac, Plug and Play Ready - WDBU6Y0020BBK-WESN
  • High capacity in a small enclosure – The small, lightweight design offers up to 6TB* capacity, making WD Elements portable hard drives the ideal companion for consumers on the go.
  • Plug-and-play expandability
  • Vast capacities up to 6TB[1] to store your photos, videos, music, important documents and more
  • SuperSpeed USB 3.2 Gen 1 (5Gbps)

Choose where Immich will keep the files

You have two practical destination models:

Destination How it works Important trade-offs
Immich upload library Assets are imported into Immich’s managed upload storage. Requires capacity in UPLOAD_LOCATION and a separate backup of the filesystem. It is the straightforward choice when Immich should own the imported files.
Immich external library Immich indexes an existing folder mounted into the server instead of copying files into the ordinary upload path. The Immich FAQ says there is no official mechanism for creating albums in an external library. Duplicate checking is limited and performed per library, and a read-only mount cannot save metadata edits.

For a one-time Google Photos migration, the upload library is usually easier to reason about because the imported assets follow Immich’s normal storage and database model. An external library can avoid another copy only when you already have a well-organized folder and accept its album, duplicate, and write-access limitations.

Step 1: Make a recovery plan

Before exporting anything, decide where the original Takeout archive will live and where the independent backup will be stored. A second disk, a NAS, or another physically separate storage location can serve as the media copy; existing hardware is sufficient if it has the required capacity and is not the same failure point as the Immich server.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Plan to retain two different kinds of backup:

  • Filesystem backup: the actual photos and videos, including Immich’s original-content folders.
  • Database backup: Immich’s records of file paths, albums, users, and other metadata.

Immich’s backup documentation identifies UPLOAD_LOCATION/library, UPLOAD_LOCATION/upload, and UPLOAD_LOCATION/profile as critical original-content folders. Backing up other generated folders can reduce regeneration work after a restore, but those three are the minimum originals called out in the guidance.

A database dump alone is not a photo backup. Immich explicitly says its built-in database backups contain metadata and do not include photo or video files. Conversely, a filesystem copy without the database can leave you with files but none of the Immich organization and metadata that points to them.

Step 2: Export Google Photos with Takeout

  1. Open Google Takeout and select Google Photos as the service to export.
  2. Request the export and download every archive Google provides. The immich-go documentation supports processing one or more Takeout ZIP files or an already extracted folder.
  3. Keep the ZIP files unchanged as an original source copy. Extract a working copy into storage that has enough room for both the media and the JSON sidecars.
  4. Do not separate the JSON files from the photos and videos. The Takeout-aware importer scans both and uses the JSON information to match metadata to the corresponding media.

Takeout is the hand-off point between Google Photos and your self-hosted system. The export is not merely a folder of images: the sidecar JSON can contain descriptions, original capture dates, locations, and album associations that would otherwise be difficult to reconstruct.

Rank #2
WD 2TB My Passport, Portable External Hard Drive, Black, backup software with defense against ransomware, and password protection, USB 3.1/USB 3.0 compatible - WDBYVG0020BBK-WESN
  • Slim durable design to help take your important files with you
  • Vast capacities up to 6TB[1] to store your photos, videos, music, important documents and more
  • Back up smarter with included device management software[2] with defense against ransomware
  • Help secure your important files with password protection and hardware encryption
  • 3-year limited warranty

Step 3: Prepare Immich

  1. Install or update your Immich server using the project’s current Quick Start instructions.
  2. Set UPLOAD_LOCATION to the destination filesystem and confirm that the account running Immich can read and write there.
  3. Check free space before importing. You need room for the destination library and should not rely on the same disk as the only backup.
  4. Complete the initial administrator setup and verify that the web interface can accept a small test upload. A test confirms storage permissions before you process a large archive.

Immich and immich-go evolve independently enough that exact version compatibility and command syntax can change. Use the current Immich Quick Start and the current immich-go upload guide for the release you install; do not assume an older command or flag is still valid.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Step 4: Import the Takeout archive with immich-go

The immich-go project’s Takeout workflow is designed for this specific job. Its documented sequence is to scan media and JSON files, catalog what it finds, match metadata to media, and then upload the resulting assets to Immich.

  1. Point immich-go at the downloaded ZIP file or at the extracted Takeout directory, according to the current upload guide.
  2. Let the scan complete so the tool can inventory media and sidecar JSON before uploading. This makes missing or unmatched items visible instead of silently treating the export as an ordinary folder.
  3. Enable the documented album-synchronization option if you want Takeout album structure recreated in Immich.
  4. Choose filters for archived, trashed, partner-shared, or unmatched items based on what you want to preserve. These categories are available as documented import controls; decide deliberately whether an item should enter your self-hosted library.
  5. Use the importer’s duplicate-checking behavior, then review its output for files it could not match.
  6. Start the upload and keep the original archive until the verification stage is complete.

Unmatched media can still be included, but the immich-go documentation warns that those assets will have less metadata. If preserving descriptions, dates, locations, or album membership matters, do not treat an unmatched report as harmless. Keep the file, inspect why the match failed, and decide whether to import it with reduced metadata or correct the source arrangement and retry.

Why matching can fail

The project documentation specifically discusses difficulties involving edited files, burst photos, and duplicates. A filename that looks obvious to a person may not be enough for an automated match when several versions share similar names or when Google’s export contains both an original and an edited derivative. The importer’s result is therefore a mapping to review, not a guarantee that every edge case will be perfect.

What transfers, and what to verify

immich-go documents importing several kinds of information from Takeout JSON and mapping the original capture date rather than relying only on a file’s modification time.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #3
Sale
Aiolo Innovation 500GB External Hard Drive Ultra Slim Portable HDD-USB 3.0 for PC, Mac, Laptop, PS4, Xbox one,Xbox 360 HD-A4
  • Ultra fast data transfers: the external hard drive works with USB 3.0 thickened copper cable to provide super fast transfer speeds. Theoretical read speed is as high as 110MB/s-133MB/s and write speed is as high as 103MB/s.
  • Ultra-thin and quiet: the motherboard adopts a noise-free solution, giving you a quiet working environment. Lightweight and portable size designed to fit in your pocket for easy portability.
  • Compatibility: compatible with PS4/xbox one/Windows/Linux/Mac/Android,Stable and fast downloading on game console no difference from fast transmission when using on PC.
  • Plug and Play: no software to install, just plug it in and the drive is ready to use. The hard drive chip is wrapped with aluminum anti-interference layer to increase heat dissipation and protect data
  • Package Contents: 1* portable hard drive, 1 *USB 3.0 cable, 1*USB to type C adapter,1 *user manual, shell packaging, three-year manufacturer's warranty and free technical support services
Data Documented behavior What to check
Original capture date The importer reads the Takeout date information and describes mapping the original capture date. Open samples from old, recent, and edited periods. Look for dates that have shifted to the export or extraction time.
Descriptions Descriptions in the Takeout JSON can be imported. Check photos with captions, especially those containing punctuation or non-English characters.
GPS coordinates Location information can be read from the Takeout metadata. Inspect representative photos on the map or location view and confirm that sensitive locations are what you intend to retain.
Albums Album synchronization is a documented immich-go option. Compare a few small, large, and shared-origin albums. Album recreation is a capability, not a promise that every unusual album edge case will map exactly.
Duplicates The importer documents duplicate checking. Review duplicate reports and verify that intentional copies, edits, and burst sequences were not incorrectly collapsed.

Do a representative audit rather than checking only the newest images. Include photos with descriptions, geotags, edits, bursts, and duplicate-looking filenames. Compare the total number of assets and the number of albums, then sample the oldest and newest capture dates.

Using XMP sidecars after the import

Immich also documents reading selected XMP sidecar fields. A sidecar must share the media filename base: examples include IMG_0001.jpg.xmp and IMG_0001.xmp. Supported reads include description, rating, date and time, GPS coordinates, and tags in the XMP fields Immich recognizes.

Support is field-specific. The documentation says unsupported XMP fields remain in the sidecar but are not searchable in Immich. Do not assume that every proprietary rating, face label, keyword namespace, or editing instruction in an XMP file becomes an Immich search field. If a particular field is important, test one file with that exact field before designing a large-scale workflow around it.

Step 5: Verify the migration before deleting anything

  1. Compare the number of Takeout media files with the number of assets shown in Immich, allowing for any filters you intentionally selected.
  2. Open representative photos and videos from different years, devices, and file types.
  3. Check original capture dates, descriptions, GPS data, ratings, and tags where they matter to you.
  4. Open several albums, including albums with edited images, bursts, or shared-origin content.
  5. Review immich-go’s unmatched and duplicate results and make a decision for every important exception.
  6. Confirm that the files exist in the destination filesystem and that a database backup has been created.
  7. Copy the original Takeout archive and the verified Immich filesystem to the independent backup location.

Only after these checks should you consider removing the Google Photos collection or deleting the local Takeout working copy. Keeping the original archive gives you a way to re-run the import if you later discover a mapping problem.

Backup Immich after the move

Immich’s database stores file paths and user metadata, and its documentation says the application does not scan the library folder to rebuild that information automatically. Schedule database backups and test that you can read them. At the same time, back up the filesystem media; the database and files are complementary, not interchangeable.

Rank #4
YOTUO 1TB External Hard Drive, Portable Storage Expansion HDD, USB 3.0 & USB-C for PC, Mac, Desktop, Laptop, Smartphone, PS4, Xbox One, Xbox 360, Office & Game, Black
  • 【Versatile Storage Expansion – For Gaming, Work & Everyday Use】 Running out of space on your PS5 or Xbox Series X/S? This external hard drive lets you store and play PS4 / Xbox One games directly, instantly freeing up your console’s internal storage for next‑gen titles. At the same time, it handles work file backups, media libraries, and cross‑device data transfers with ease. One drive, all your needs. *(Note: PS5 / Xbox Series X|S games cannot be run or stored directly from the external hard drive. However, by offloading your PS4 / Xbox One games, you can free up valuable space for newer titles.)*
  • 【Patented Silicone Sleeve – Data Protection You Can Count On】 Worried about drops? We’ve got you covered. The patented built‑in silicone sleeve acts like a shock‑absorbing armor, cushioning your drive against bumps and falls. Whether it’s important work documents, precious family photos, or hard‑earned game saves, your data deserves this level of protection.
  • 【Plug & Play, Compatible with Computers & Consoles】 No complicated setup—just plug in and go. Works seamlessly with Windows, Mac, and Linux computers, as well as PS4, PS5, Xbox One, and Xbox Series X/S. Process files at the office, back up data at home, or enjoy gaming in your downtime—one drive handles all your devices, simply and hassle‑free.
  • 【USB 3.0 Ultra‑Fast Transfer – No More Waiting】 Tired of watching progress bars crawl? With USB 3.0 speeds up to 5Gbps, large files transfer in seconds. Whether you’re moving work documents, transferring hundreds of gigs of games, or backing up a year’s worth of photos, you get more done in less time.
  • 【Sleek, Lightweight, and Ready to Go】 Weighing just 0.16 kg—lighter than a can of soda—this compact drive features a stylish mirror‑and‑frosted finish. Toss it in your bag and go, whether you’re heading to the office, visiting a friend for a gaming session, or giving a presentation on the road.

A practical backup set

  • Primary Immich storage: the configured upload location on the server.
  • Filesystem copy: at least UPLOAD_LOCATION/library, UPLOAD_LOCATION/upload, and UPLOAD_LOCATION/profile on separate storage.
  • Database dumps: recurring exports stored away from the server.
  • Original Takeout: the untouched ZIP archive and, if useful, the extracted folder with its JSON files.

After a restore, the filesystem copy supplies the media while the database restores Immich’s paths and metadata. Backing up generated content as well can save time, but it does not remove the need to protect the original-content folders and the database separately.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

When an external library is the better choice

An external library is reasonable when your files already live in a folder you manage independently and you want Immich to index them without copying them into its upload storage. It is less suitable when album recreation, duplicate handling across multiple locations, or metadata editing from Immich is central to the migration.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  • There is no official external-library album-creation mechanism in the Immich FAQ.
  • Duplicate checking is limited and operates per external library rather than as a universal check across all libraries.
  • A read-only mount prevents Immich from saving metadata edits back to the files or their location.

Those constraints make the external-library route a deliberate storage architecture, not a shortcut that preserves every behavior of an uploaded collection.

Troubleshooting decision points

Albums are missing or incomplete

Confirm that album synchronization was enabled and that you imported the JSON sidecars alongside the media. Check whether the affected items were filtered as archived, trashed, partner-shared, or unmatched. If the files were unmatched, less metadata is expected and album association may not be available.

Dates are wrong

Inspect the original Takeout JSON and the importer’s match result for an affected file. Edited files, bursts, and duplicates are documented sources of matching difficulty. Do not “fix” a whole collection by changing filesystem modification times; the importer is intended to use original capture-date metadata.

Best Value
WD 4TB My Passport, Portable External Hard Drive, Black, Backup Software with Defense Against ransomware, and Password Protection, USB 3.1/USB 3.0 Compatible - WDBPKJ0040BBK-WESN
  • Slim durable design to help take your important files with you
  • Vast capacities up to 6TB[1] to store your photos, videos, music, important documents and more
  • Back up smarter with included device management software[2] with defense against ransomware
  • Help secure your important files with password protection and hardware encryption
  • 3-year limited warranty

Some files imported without descriptions or locations

Look for an unmatched report and verify that the JSON sidecar’s filename relationship is intact. If the information is in XMP instead, confirm that it is in one of Immich’s supported fields and that the sidecar base name matches the media file.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

The server runs out of space

Stop the import, preserve the original Takeout archive, and increase available destination capacity before retrying. Remember that extraction, destination storage, and backup copies can coexist during migration; sizing only for the final library is insufficient.

A restore shows files but no organization

Restore the matching Immich database backup as well as the filesystem folders. A database dump does not contain the photos and videos, while a filesystem copy alone does not recreate Immich’s metadata and paths.

Recommended sequence in one checklist

  • Choose upload-library or external-library storage, understanding the external-library limits.
  • Reserve space for archives, extraction, destination files, and a separate backup.
  • Export Google Photos with Takeout and retain every archive plus its JSON files.
  • Prepare Immich and set a writable UPLOAD_LOCATION.
  • Run the current immich-go Takeout workflow with album synchronization and the filters you actually want.
  • Review counts, albums, dates, descriptions, locations, duplicates, and unmatched items.
  • Back up the database and the critical filesystem folders independently.
  • Keep the original Takeout archive until the migration and restore plan have both been tested.

The Immich Quick Start and XMP and backup documentation were updated October 8, 2026, while immich-go is a community-maintained, moving document. Exact behavior can change with later releases, so check the current guides for your installed versions and validate with your own Takeout archive.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Google PhotosGoogle TakeoutImmichimmich-gophoto backupself-hosted photo gallery

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Recommended PC Tool
Recommended PC Tool
Crashes, No Sound, or Screen Glitches?Free driver scan
PC Slower Than It Used to Be?Free scan - under a minute

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.