immich-go(1)

📦 version 0.32.0, in ubuntu stonking

💖 immich-go-upload-from-folder — aka immich-go upload from-folder 💖

okay bestie, gather round, because this is the page you're gonna want open in a second terminal while you're yeeting an entire folder of photos at your Immich server 🫶. This lives inside the immich-go manual, and it's the "I have a folder, I have a server, let's make it happen" command. No cap.

🌸 NAME 🌸

immich-go-upload-from-folder — upload photos from a folder. that's it. that's the vibe. ✨

🦋 SYNOPSIS 🦋

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

yes the ... is real, she takes flags and she takes args, and she will not be stopped 💅

🎀 DESCRIPTION 🎀

Upload photos from a folder. fr fr that's the whole description, the real tea is all down in the options, so keep scrolling, bestie 👑

✨ OPTIONS ✨

like... a LOT of options. but we're going through every single one because I refuse to gatekeep 🔥

  • --album-path-joiner=" / " — the little string she uses to glue multiple folder names together when she's building an album name. like, examples in the wild: ' ' and ' - '. so you can have Summer - 2024 or whatever cute thing you want 🎀
  • --ban-file='@eaDir/', '@__thumb/', 'SYNOFILETHUMB.', 'Lightroom Catalog/', 'thumbnails/', '.DSStore', '/.*', '.Spotlight-V100/', '.photostructure/', 'Recently Deleted/' — the block list, the "not you" list. it excludes a file based on a pattern, and the matching is case-insensitive. you can drop this flag multiple times to ban multiple things 🚫
  • --date-from-name[=true] — if the date is just... not in the metadata (crying), she'll steal it from the filename instead. and it only works for these file types, no exceptions bestie: jpg, mp4, heic, dng, cr2, cr3, arw, raf, nef, mov 🗓️
  • --date-range=unset — only import photos taken inside the date range you specify. keep it tight, keep it curated 💖
  • --exclude-extensions= — a comma-separated list of extensions you want OUT. example: .gif,.PM. default is none, so by default nothing gets excluded 🙈
  • --folder-as-album=NONE — this one is iconic. it imports all files into albums defined by your folder structure. set it to 'FOLDER' and the folder name becomes the album name, set it to 'PATH' and the whole full path becomes the album name. main character behavior, honestly 👑
  • --folder-as-tags[=false] — flip your folder structure into tags instead. example straight from the source: the file holiday/summer 2024/file.jpg will have the tag holiday/summer 2024 🏷️
  • -h, --help[=false] — help for from-folder. classic.
  • --ignore-sidecar-files[=false] — don't upload the sidecar with the photo. sidecar said not today 🚫
  • --include-extensions= — a comma-separated list of extensions you want IN. example: .jpg,.heic. default is all because she is generous 💅
  • --include-type= — one single file type to include. your options are VIDEO or IMAGE. default is all 🌈
  • --into-album="" — name an album and every single file goes in there. the group chat of albums 🫶
  • --recursive[=true] — explore the folder and all its sub-folders. it's on by default because she's thorough like that 🧚

👑 OPTIONS INHERITED FROM PARENT COMMANDS 👑

these come from the parent, so they work here too. yes, all of them. no skipping 💜

  • --admin-api-key="" — the admin's API key, for managing the server's jobs 🔑
  • -k, --api-key="" — the regular API key 🔐
  • --api-trace[=false] — turn on tracing of api calls. for when you need to see everything 👀
  • --client-timeout=20m0s — sets the timeout for server calls ⏳
  • --concurrent-tasks=16 — how many concurrent tasks she runs. legal range is 1–20, and she defaults to a very confident 16 🔥
  • --config="" — the config file. default is ./immich-go.yaml 📄
  • --device-uuid="framework" — set a device UUID 🆔
  • --dry-run[=false] — simulate ALL the actions. nothing actually happens, it's just a rehearsal, it's giving dress rehearsal 🎭
  • -l, --log-file="" — write log messages into the file 📝
  • --log-level="INFO" — log level, pick from DEBUG, INFO, WARN, ERROR. default is INFO — and honestly same, INFO is the balanced queen 👸
  • --log-type="text" — log formatted as text or a JSON file. default is text 🪄
  • --manage-burst=NoStack — manages burst photos. possible values: NoStack, Stack, StackKeepRaw, StackKeepJPEG 📸
  • --manage-epson-fastfoto[=false] — manages Epson FastFoto files. default is false 🖨️
  • --manage-heic-jpeg=NoStack — manages coupled HEIC and JPEG files. possible values: NoStack, KeepHeic, KeepJPG, StackCoverHeic, StackCoverJPG 🖼️
  • --manage-raw-jpeg=NoStack — manages coupled RAW and JPEG files. possible values: NoStack, KeepRaw, KeepJPG, StackCoverRaw, StackCoverJPG 🎞️
  • --no-ui[=false] — disables the user interface. bye bye pretty screen 😭
  • --on-errors=stop — what she does when an error shows up. your options: stop, continue, or accept N errors at max. default is stop, she does not play 💀
  • --overwrite[=false] — always overwrite the files on the server with your local versions. careful bestie, this one does exactly what it says ⚠️
  • --pause-immich-jobs[=true] — pause Immich background jobs while upload operations are running. on by default, she's polite ✋
  • --save-config[=false] — saves the configuration to immich-go.yaml 💾
  • -s, --server="" — your Immich server address. examples from the source, verbatim: http://your-ip:2283 or https://your-domain 🌐
  • --session-tag[=false] — tags every uploaded photo with a tag formatted like "{immich-go}/YYYY-MM-DD HH-MM-SS" 🏷️
  • --skip-verify-ssl[=false] — skips SSL verification 🙈
  • --tag=[] — add tags to the imported assets. can be specified multiple times. hierarchy is supported with a / separator, example: 'tag1/subtag1' 💖
  • --time-zone="" — override the system time zone. you're the boss of time now 🕰️

🌈 SEE ALSO 🌈

📜 HISTORY 📜

28-Mar-2026 — Auto generated by spf13/cobra. yep, a robot did it. and she ate 🤖✨

okay that's the whole page, bestie, you're fully caught up 💅 this doc came to you from the immich-go manual page, auto generated by spf13/cobra, dated Mar 2026 — so if anything's weird, blame the cobra, not me 🐍😭. now go upload those photos, you absolute icon 👑💖

📦 where this page comes from