immich-go(1)

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