immich-go(1)

📦 version 0.32.0, in ubuntu stonking

💖 immich-go-upload — bestie edition 💖

okay so this is a page from the immich-go manual, and today we're doing the upload command. it does exactly what it says on the tin: it sends your photos to an Immich server. no cap. let's get into it ✨

🌸 NAME 🌸

immich-go-upload — Upload photos to an Immich server from various sources 🫶

🎀 SYNOPSIS 🎀

immich-go upload [flags]

🦋 DESCRIPTION 🦋

Upload photos to an Immich server from various sources 🌈

that's it. that's the whole vibe. you point it at a source, you point it at your server, and your pics go home 💅

✨ OPTIONS ✨

  • --admin-api-key="" — the Admin's API Key, for managing the server's jobs 👑
  • -k, --api-key="" — your API Key, the little keycard that gets you in 🔑
  • --api-trace[=false] — turn on tracing of api calls, if you're the kind of girl who needs to see everything 👀
  • --client-timeout=20m0s — how long server calls are allowed to hang before we call it, timeout style ⏰
  • --device-uuid="framework" — set a device UUID, so the server knows which device these came from 🏷️
  • --dry-run[=false] — simulate ALL the actions, do absolutely none of them. your test-run bestie 🧪
  • -h, --help[=false] — help for upload, hi hello, here's the help 🫶
  • --manage-burst=NoStack — manage burst photos. possible values: NoStack, Stack, StackKeepRaw, StackKeepJPEG 📸
  • --manage-epson-fastfoto[=false] — manage Epson FastFoto files (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, for when you want zero ✨drama✨ and just logs 🫥
  • --overwrite[=false] — always overwrite files on the server with the local versions. girl, be careful with this one 💀
  • --pause-immich-jobs[=true] — pause Immich background jobs while the upload is happening ⏸️
  • -s, --server="" — your 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. can be specified multiple times. hierarchy is supported using a / separator (e.g. 'tag1/subtag1') 🌈
  • --time-zone="" — override the system time zone 🕰️
real talk bestie: --skip-verify-ssl and --overwrite are the two that can genuinely ruin your day, so know what you're doing before you type them. and remember --dry-run exists — use it first. 💅

👑 OPTIONS INHERITED FROM PARENT COMMANDS 👑

these are the ones that come from the parent command, they're not upload's own but you still get them 💜

  • --concurrent-tasks=16 — number of concurrent tasks (1-20) ⚡
  • --config="" — config file (default is ./immich-go.yaml) 📄
  • -l, --log-file="" — write log messages into the file 📝
  • --log-level="INFO" — log level (DEBUG|INFO|WARN|ERROR), default INFO 🔍
  • --log-type="text" — log formatted as text of JSON file 🧾
  • --on-errors=stop — what to do when an error occurs (stop, continue, accept N errors at max) 🛑
  • --save-config[=false] — save the configuration to immich-go.yaml 💾

🌟 SEE ALSO 🌟

go read the whole family, they all ate 🔥

📜 HISTORY 📜

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

okay that's the whole page bestie, you're officially an immich-go upload girlie now 🧚💖 this edition of the immich-go(1) manual was auto generated by spf13/cobra, Mar 2026 — periodt, no notes, go upload something iconic ✨🌸

📦 where this page comes from