© 2026 Hedgehog Software, LLC

TwitterGitHubDiscord
More
CommunitiesDocsAboutTermsPrivacy
Search
Star
Setup for Free
ImmichI
Immich•10mo ago•
5 replies
mglakner

Immich-CLI docker container exits immediately

Immich OS: Linux Debian CLI

Issue: Installed Immich-CLI Docker through CLI. In Portainer, it immediatley exits, logs are
Usage: immich [options] [command]

Command line interface for Immich

Options:
  -V, --version                       output the version number
  -d, --config-directory <directory>  Configuration directory where auth.yml
                                      will be stored (default:
                                      "/root/.config/immich/", env:
                                      IMMICH_CONFIG_DIR)
  -u, --url [url]                     Immich server URL (env:
                                      IMMICH_INSTANCE_URL)
  -k, --key [key]                     Immich API key (env: IMMICH_API_KEY)
  -h, --help                          display help for command

Commands:
  login|login-key <url> <key>         Login using an API key
  logout                              Remove stored credentials
  server-info                         Display server information
  upload [options] [paths...]         Upload assets
  help [command]                      display help for command
Usage: immich [options] [command]

Command line interface for Immich

Options:
  -V, --version                       output the version number
  -d, --config-directory <directory>  Configuration directory where auth.yml
                                      will be stored (default:
                                      "/root/.config/immich/", env:
                                      IMMICH_CONFIG_DIR)
  -u, --url [url]                     Immich server URL (env:
                                      IMMICH_INSTANCE_URL)
  -k, --key [key]                     Immich API key (env: IMMICH_API_KEY)
  -h, --help                          display help for command

Commands:
  login|login-key <url> <key>         Login using an API key
  logout                              Remove stored credentials
  server-info                         Display server information
  upload [options] [paths...]         Upload assets
  help [command]                      display help for command

I used the compose from the immich site
docker run -it -v "$(pwd)":/import:ro -e IMMICH_INSTANCE_URL=https://your-immich-instance/api -e IMMICH_API_KEY=your-api-key ghcr.io/immich-app/immich-cli:latest
docker run -it -v "$(pwd)":/import:ro -e IMMICH_INSTANCE_URL=https://your-immich-instance/api -e IMMICH_API_KEY=your-api-key ghcr.io/immich-app/immich-cli:latest


It installed fine, but just exits with a code 1. Now i am not familiar with Immich-CLI and to be honest the page for it here https://immich.app/docs/features/command-line-interface/ lacks much needed instruction for those who haven't used it before.

Question: Do i need to run the docker compose inside a specific folder or point to something specfic? Does it need an .env? A little nudge in the right direction and I think ill be able to handle it.
ImmichJoin
A place to hang out, get support, discuss Immich, get announcements about releases and anything else going on.
36,590Members
Resources

Similar Threads

Was this page helpful?
Recent Announcements

Similar Threads

Immich Docker cli
ImmichIImmich / help-desk-support
13mo ago
Running immich cli inside docker container - exec not found
ImmichIImmich / help-desk-support
6mo ago
Immich Server Docker Container Permission Issues
ImmichIImmich / help-desk-support
7mo ago
Immich-CLI docker command on windows
ImmichIImmich / help-desk-support
2mo ago