Migration Guide Self-Hosted immich-go v0.32.0

How to Migrate Google Photos to Immich (2026)

The shortest route is immich-go, the community tool Immich's own documentation recommends for Google Takeout. It reads your Takeout .zip files as they are, pairs each photo with its .json file and sends the real date, GPS, description, favourite and albums to Immich, in one command. What it does not do is fix the files: the corrected metadata lives in Immich, while the photos keep the dates Takeout left in them. If you want files that are right everywhere — backups, a NAS, whatever app comes after Immich — repair the export first with FolioSort (free, no file limit), then upload.

Pick by what you want to end up with

  • Just get the library into Immich: immich-go on its own — the steps are below.
  • Correct files on disk as well: FolioSort's Takeout repair first, then immich-go or any uploader — when that is worth it.
Takeout repair is free, with no file limit No account, no sign-up Runs on your Mac or PC — nothing uploaded

FolioSort makes this page and one of the tools on it. immich-go and Immich are independent open-source projects; every fact about them below comes from their own documentation, checked again on 12 November 2026.

What each route does with your Takeout

Google exports what it knows beyond the file itself — the date and place as Google Photos shows them, captions, people, favourites — in a separate .json file next to each photo. Whether that information reaches Immich depends on what reads those files.

RouteReads Google's .json filesFixes the files themselvesTakes the .zip as isBest for
immich-go upload from-google-photosYes — date, GPS, description, favourite, archived, albumsNo — sets them in Immich through its APIYes, every part in one commandGetting a Takeout into Immich quickly, with Google's albums
FolioSort Takeout repair, then any uploaderYes — date, GPS, favourites, tagged people, captionsYes — written into each fileNo — unzip all parts into one folderA library that is correct outside Immich too
Immich web upload or mobile appNoNoNoNew photos, and files that already carry their date
Immich CLINo — its docs cover .xmp sidecars and send Takeout users to immich-goNoNoUploading folders that are already correct
Immich External LibraryNot mentioned in Immich's docs, which cover EXIF and .xmpNoNoFiles that stay on your own disk or NAS, already correct

Google says camera photos keep their original date inside the file. What exists only in the .json is the date of images that never had one inside — typically pictures saved from messaging apps, screenshots and scans — and any date or place you corrected in Google Photos. With no date inside a file, Immich falls back on the file's own dates, usually the day you downloaded the export, which is why a straight upload can pile those photos onto one day. What the .json files hold →

Google Photos to Immich with immich-go, step by step

Based on immich-go v0.32.0 (June 2026, still the latest release on 12 November 2026), which supports Immich v2 and v3. immich-go is a single program for macOS, Windows, Linux and FreeBSD — no Node.js or Docker needed.

  1. Request the Takeout

    On takeout.google.com, click Deselect all, tick Google Photos, and choose .zip with the largest part size (50 GB). Download every part when Google emails you. Avoid .tgz: immich-go cannot read it without extracting it first.

  2. Create an API key in Immich

    In Immich's web interface: Account settings → API Keys → New API Key. By default immich-go pauses Immich's background jobs (thumbnails, machine learning) while it uploads, which needs a key from an admin account; with a regular account, add --pause-immich-jobs=false to the commands below.

  3. Install immich-go

    Download the archive for your system from the immich-go releases page and extract it — or on a Mac with Homebrew: brew install immich-go.

  4. Do a dry run

    Pass every part of the export in one command — a photo's .json can sit in a different part from the photo — and add --dry-run to see what would happen without uploading anything:

    immich-go upload from-google-photos --server=http://your-ip:2283 --api-key=YOUR_API_KEY --dry-run /path/to/takeout-*.zip
  5. Run the import

    The same command without --dry-run. For very large libraries, immich-go's own best-practice guide suggests --concurrent-tasks=4 --client-timeout=60m --on-errors=continue. If it stops, run it again: files already on the server are recognised by checksum and skipped.

  6. Check what was left out

    Two defaults surprise people. Files that have no matching .json are not imported unless you add --include-unmatched, and photos in Google's trash are skipped unless you add --include-trashed. Compare the photo count in Immich with your Google Photos library, then spot-check dates, places and albums.

When to fix the files first — and when not to

immich-go uploads each original file unchanged and sets the corrected date and place in Immich's database. Immich's FAQ: "Immich does not modify the original files." So the photos themselves keep the dates Takeout gave them.

Repair the files first if…

  • you keep the Takeout, or a folder copy, as your backup
  • the same library also lives on a NAS or an external drive
  • you may move from Immich to another app one day
  • you want Year / Month folders you can browse without Immich

immich-go alone is enough if…

  • Immich is where the library lives from now on
  • you back up the Immich server itself
  • Google's albums inside Immich matter more to you than the files — immich-go is the route that recreates them

How the repair works in FolioSort

  1. Unzip every part of the export into the same folder, so each photo can find its .json.

  2. In FolioSort, open the Google Photos screen, choose that folder as the Takeout Folder and click Scan. You see how many photos were Matched with their .json, and the Orphans with the reason for each.

  3. Pick a Destination Folder on another drive, keep Copy so the export stays untouched, and run the import. The real capture date and GPS are written into each file, plus favourites as a 5-star rating, the people tagged in Google Photos as keywords, and captions.

  4. Upload the repaired folder with immich-go, the Immich CLI, the web uploader or an External Library — Immich now reads the dates from the files themselves.

The repair is free on Mac and Windows with no file limit. Pro (€29.99, one-time) adds Year / Month folders in the same run and keeps one copy of each photo that Takeout exported once per album. Everything runs on your computer; nothing is uploaded. What the import reads and writes, field by field →

FolioSort on macOS repairing a Google Takeout folder — capture dates and GPS restored from the .json files, with a preview of the organized folders

Frequently asked questions

Why do my photos show the wrong date in Immich after uploading a Takeout?

Camera photos keep their original date inside the file, but images that never had one — often from messaging apps, screenshots or scans — and any date you corrected in Google Photos exist only in Google's separate .json file. Immich reads the date from the file, and when there is none it falls back on the file's own dates, usually the day you downloaded the export. Import with immich-go, which reads the .json files, or repair the files with FolioSort before uploading.

Do I need to unzip the Takeout before using immich-go?

No. immich-go reads the .zip parts directly; pass all of them in one command, because a photo's .json can be in a different part. Only .tgz exports must be extracted first. FolioSort's repair works on an unzipped export, with every part extracted into the same folder.

Why are some photos missing after the immich-go import?

By default immich-go skips files that have no matching .json and photos that were in Google's trash. Run the command again with --include-unmatched (and --include-trashed if you want those); it is safe to re-run, because files already in Immich are skipped by checksum.

Does immich-go change my photo files?

No. It uploads each original file unchanged and sets the date, location, description and favourite in Immich through its API. Immich itself does not modify original files either, so the photos keep the metadata Takeout gave them. To have the dates written into the files, repair the export with FolioSort first.

Will the import create duplicates in Immich?

Takeout exports a photo once per album plus once in its year folder. immich-go uploads it once and adds it to each album, and skips anything already on the server by checksum. In FolioSort, Pro keeps one copy of each album duplicate during the repair.

Is FolioSort free for this, and does it upload my photos?

The Takeout repair is free on Mac and Windows with no file limit, and it runs entirely on your computer — nothing is uploaded. Pro (€29.99, one-time, no subscription) adds date folders and the clean-up of album duplicates in the same run.

Does this work on Windows?

Yes. immich-go has builds for Windows, macOS, Linux and FreeBSD, and FolioSort runs on Windows 10+ and macOS 14+ with the same Takeout repair.

More migration guides

Give Immich files that are right on their own.

Repair the whole Takeout free — no file limit — so the real dates and places are inside every file before Immich, or anything after it, ever sees them.

14-day guarantee Files processed locally macOS 14+ & Windows 10+