immich-go(1)

📦 version 0.32.0, in ubuntu stonking

💖 immich-go 💖

okay bestie, welcome to the immich-go manual page — yes that's the manual name, and yes we're about to make it make sense. this is the glow-up you needed. ✨

🦋 NAME

immich-go-upload-from-icloud — upload photos from an iCloud takeout folder or zip file 🍓

✨ SYNOPSIS

immich-go upload from-icloud [flags] ...

🌸 DESCRIPTION

Upload photos from an iCloud takeout folder or zip file. that's the whole vibe. your iCloud export goes in, your Immich server gets the pics. periodt. 👑

💅 OPTIONS

  • --album-path-joiner=" / " — tell it what string to glue multiple folder names together with when it's making an album name (like ' ' or ' - ', you know, whatever slays) ✨
  • --ban-file='@eaDir/', '@__thumb/', 'SYNOFILETHUMB.', 'Lightroom Catalog/', 'thumbnails/', .DSStore, /.*, .Spotlight-V100/, .photostructure/, Recently Deleted/' — exclude a file based on a pattern, and the matching is case-insensitive. you can hit this flag as many times as you want, no cap. 🚫
  • --date-from-name[=true] — if the metadata ghosted you and there's no date, use the date from the filename instead. heads up though: this only works for jpg, mp4, heic, dng, cr2, cr3, arw, raf, nef, mov 🙈
  • --date-range=unset — only import photos that were actually taken within the date range you specify. if you don't specify one, it's unset.
  • --exclude-extensions= — comma-separated list of extensions to exclude (e.g. .gif,.PM). default is none, so nothing gets left out unless you say so 💅
  • --folder-as-album=NONE — import every file into albums defined by the folder structure. set it to FOLDER and the folder name becomes the album name, or set it to PATH and the whole full path becomes the album name. iconic choices only. 🎀
  • --folder-as-tags[=false] — use the folder structure as tags. example, fr fr: a file at holiday/summer 2024/file.jpg gets the tag holiday/summer 2024 🌈
  • -h, --help[=false] — help for from-icloud 🫶
  • --ignore-sidecar-files[=false] — don't upload the sidecar along with the photo. leave it at home. 🚫
  • --include-extensions= — comma-separated list of extensions to include (e.g. .jpg,.heic). default is all of them ⭐
  • --include-type= — a single file type to include, either VIDEO or IMAGE. default is all. pick your fighter 💜
  • --into-album="" — name an album and every single file goes in there. no crumbs left behind 🍓
  • --memories[=false] — import iCloud memories as albums. the nostalgia is the point 😭
  • --recursive[=true] — explore the folder and every single one of its sub-folders. yes, all of them. go deep 🦋

👑 OPTIONS INHERITED FROM PARENT COMMANDS

  • --admin-api-key="" — the admin's API key, for managing the server's jobs 🔥
  • -k, --api-key="" — API key
  • --api-trace[=false] — enable trace of api calls
  • --client-timeout=20m0s — set the server calls timeout ⏰
  • --concurrent-tasks=16 — number of concurrent tasks, and it's gotta be between 1 and 20 💅
  • --config="" — config file (default is ./immich-go.yaml)
  • --device-uuid="framework" — set a device UUID
  • --dry-run[=false] — simulate all the actions, do none of them. cost-free chaos, we love to see it ✨
  • -l, --log-file="" — write log messages into the file
  • --log-level="INFO" — log level, one of DEBUG|INFO|WARN|ERROR, and the default is INFO
  • --log-type="text" — log formatted as text of JSON file
  • --manage-burst=NoStack — manage burst photos. possible values: NoStack, Stack, StackKeepRaw, StackKeepJPEG
  • --manage-epson-fastfoto[=false] — manage Epson FastFoto file (default: false)
  • --manage-heic-jpeg=NoStack — manage coupled HEIC and JPEG files. possible values: NoStack, KeepHeic, KeepJPG, StackCoverHeic, StackCoverJPG
  • --manage-raw-jpeg=NoStack — manage coupled RAW and JPEG files. possible values: NoStack, KeepRaw, KeepJPG, StackCoverRaw, StackCoverJPG
  • --no-ui[=false] — disable the user interface. no pretty screen, just vibes 🌸
  • --on-errors=stop — what to do when an error occurs: stop, continue, or accept N errors at max. choose wisely bestie
  • --overwrite[=false] — always overwrite files on the server with the local versions. highkey destructive, you've been warned 💀
  • --pause-immich-jobs[=true] — pause Immich background jobs while upload operations are happening ⏸️
  • --save-config[=false] — save the configuration to immich-go.yaml
  • -s, --server="" — Immich server address (example http://your-ip:2283 or https://your-domain) 🌐
  • --session-tag[=false] — tag uploaded photos with a tag formatted "{immich-go}/YYYY-MM-DD HH-MM-SS" 🏷️
  • --skip-verify-ssl[=false] — skip SSL verification 🙈
  • --tag=[] — add tags to the imported assets. you can specify it multiple times, and hierarchy is supported using a / separator (e.g. 'tag1/subtag1') 🌈
  • --time-zone="" — override the system time zone 🕐

🔗 SEE ALSO

📜 HISTORY

  • 28-Mar-2026 — Auto generated by spf13/cobra
a lil reminder bestie: this whole page was auto generated by spf13/cobra, and the page itself is immich-go(1), dated Mar 2026 — so if something looks weird, blame the generator, not me 💖

stay slaying, go upload those photos 🫶✨🎀

📦 where this page comes from