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

OPTIONS¶

--admin-api-key="" Admin's API Key for managing server's jobs

-k, --api-key="" API Key

--api-trace[=false] Enable trace of api calls

--client-timeout=20m0s Set server calls timeout

--device-uuid="framework" Set a device UUID

--dry-run[=false] Simulate all actions

-h, --help[=false] help for upload

--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

--overwrite[=false] Always overwrite files on the server with local versions

--pause-immich-jobs[=true] Pause Immich background jobs during upload operations

-s, --server="" Immich server address (example http://your-ip:2283 or https://your-domain)

--session-tag[=false] Tag uploaded photos with a tag "{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

OPTIONS INHERITED FROM PARENT COMMANDS¶

--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¶

immich-go(1), immich-go-upload-from-folder(1), immich-go-upload-from-google-photos(1), immich-go-upload-from-icloud(1), immich-go-upload-from-immich(1), immich-go-upload-from-picasa(1)

HISTORY¶

28-Mar-2026 Auto generated by spf13/cobra