immich-go(1)

📦 version 0.32.0, in ubuntu stonking

🦋 immich-go(1) — the archive from-folder page, bestie edition 💖

okay so you opened the manual for immich-go, specifically the archive from-folder subcommand, and honestly? iconic choice. this is the one that grabs a folder full of pics off your disk and yeets them up into your Immich server. let's get into it. ✨

🌸 NAME 🌸

immich-go-archive-from-folder — Upload photos from a folder

like. that's it. that's the whole job. upload photos from a folder. simple queen behaviour. 👑

✨ SYNOPSIS ✨

immich-go archive from-folder [flags] ...

💅 DESCRIPTION 💅

Upload photos from a folder.

yep, that's literally the entire description the devs gave us 😭 no notes, no lore, just vibes. so let's go look at the flags, because THAT'S where the drama is.

🎀 OPTIONS 🎀

  • --album-path-joiner=" / " — the lil string that gets shoved in between folder names when it's mashing multiple folder names together into one album name. you can customise it, like ' ' or ' - '.
  • --ban-file='@eaDir/', '@__thumb/', 'SYNOFILETHUMB.', 'Lightroom Catalog/', 'thumbnails/', '.DSStore', '/.*', '.Spotlight-V100/', '.photostructure/', 'Recently Deleted/' — blocks a file based on a pattern, and it does NOT care about case (case-insensitive, periodt). you can drop this flag multiple times if you've got multiple patterns to banish. 🚫
  • --date-from-name[=true] — if the date isn't chillin' in the metadata, steal it from the filename instead. this only works for jpg, mp4, heic, dng, cr2, cr3, arw, raf, nef, mov — so don't get cute with your pngs.
  • --date-range=unset — only import photos that were taken inside the date range you specify. little time-travel filter, love that for you. 🕰️
  • --exclude-extensions= — comma-separated list of extensions to exclude, e.g. .gif,.PM (default: none — nothing gets excluded unless you say so).
  • --folder-as-album=NONE — imports all the files into albums that the folder structure defines. 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.
  • --folder-as-tags[=false] — uses your folder structure as tags. example given in the source: a file at holiday/summer 2024/file.jpg ends up with the tag holiday/summer 2024. oh she's organised. 🗂️
  • -h, --help[=false] — help for from-folder. classic.
  • --ignore-sidecar-files[=false] — don't upload the sidecar alongside the photo. it's giving "i'm leaving the plus-one at home". 🙈
  • --include-extensions= — comma-separated list of extensions to include, e.g. .jpg,.heic (default: all — everything's invited).
  • --include-type= — a single file type to include. your options are VIDEO or IMAGE (default: all, so both).
  • --into-album="" — name an album and every single file gets imported into it. everyone in the group chat, no exclusions. 📥
  • --recursive[=true] — explores the folder AND all its little sub-folders. dig deep, bestie. 🔍

🫶 OPTIONS INHERITED FROM PARENT COMMANDS 🫶

these ones aren't unique to this command, they're handed down from the parent, and they still fully apply. respect the family tree. 🌳

  • --concurrent-tasks=16 — number of concurrent tasks, and the allowed range is 1-20.
  • --config="" — config file (default is ./immich-go.yaml).
  • --dry-run[=false] — dry run. look ma, no writes. 👀
  • -l, --log-file="" — write log messages into the file.
  • --log-level="INFO" — log level, the choices are DEBUG|INFO|WARN|ERROR, default is INFO.
  • --log-type="text" — logs get formatted as text or as a JSON file.
  • --on-errors=stop — what to do when an error shows up: stop, continue, or accept N errors at max.
  • --save-config[=false] — saves the configuration to immich-go.yaml.
  • -w, --write-to-folder="" — path where to write the archive.

🌈 SEE ALSO 🌈

immich-go-archive(1) — go read that one too, it's the main character. ⭐

📜 HISTORY 📜

28-Mar-2026 — Auto generated by spf13/cobra.

friendly reminder bestie: --dry-run exists, and it is RIGHT THERE. be a little cautious, you'll thank yourself. 🫶

alright, that's the whole page, no cap ✨ and for the sign-off: this manual is Auto generated by spf13/cobra, it's dated Mar 2026, and it lives under the immich-go(1) manual name — so when you're poking around the system, that's the label you're looking for. now go upload your camera roll, you ate 💅🎀

📦 where this page comes from