All apps/Immich CLI

Immich CLI

immich-cli

A command-line interface for Immich.

Runs as immich|macOS, Linux, Windows|immich.app

Command form

ai-draft · 2 tasks · 10 fields

Upload photos and videos to an Immich server. Login, logout, server-info and the delete-after-upload flags are outside this form.

Opens the form; the finished command lands at your prompt, unrun
otty gui immich-cli

immich upload

Upload assets

Upload files or directories to the logged-in Immich server.

Upload assetsExample values, fixed in this page — nothing here reaches a terminal
Basic
Files or directories*
any
Include subfolders
--recursive
TasksEach one presets the form for one job
Upload a folder
pathsrecursive
Preview an upload
pathsrecursivedry_run
ParametersOnly these flags are editable in the form
Files or directories
path · positional 0 · repeatable
Include subfolders
boolean
--recursive-r
Dry run
Show what would happen without uploading.
boolean
--dry-run-n
Create albums from folder names
boolean
--album-a
Album name
string
--album-name-A
Ignore pattern
string
--ignore-i
Skip hashing
boolean
--skip-hash
Include hidden folders
boolean
--include-hidden-H
Concurrent uploads
integer
--concurrency-c
JSON output
boolean
--json-output-j
SourcesEvery flag above is checked against these
help
Usage: immich upload [paths...] [options] Arguments: paths One or more paths to assets to be uploaded Options: -r, --recursive Recursive (default: false, env: IMMICH_RECURSIVE) -i, --ignore <pattern> Pattern to ignore (env: IMMICH_IGNORE_PATHS) -h, --skip-hash Don't hash files before upload (default:…
manual2026-10-27

immich.app

Before it fills your prompt, Otty checks the installed immich against its version. A form that does not match your version is not offered.