immich-power-tools

Official

Overview

Unofficial Immich client for advanced library management. Features include bulk people management, smart face merge, location enrichment, album discovery, library analytics, natural language search, and bulk date adjustment. Connects to your Immich server via API and directly to the PostgreSQL database for advanced operations. Must be on the same Docker network as immich-server and immich-vectorchord-db.

Requirements

Requires immich-server and immich-vectorchord-db on the same Docker network (immich_internal). Create an API key in Immich with ALL permissions: Account Icon → Account Settings → API Keys → New API Key → Select All → Create. Full setup guide: https://rorar.github.io/immich-unraid-manual/

Runtime arguments

Web UI: http://[IP]:[PORT:3000]
Network: immich_internal
Shell: sh
Privileged: false
Extra Params: --user 99:100

Template configuration

Port: Web UIPorttcp

Power Tools web interface port.

Target: 3000
Default: 3000
Value: 3000

Path: DataPathrw

Persistent data directory for Power Tools.

Target: /app/data
Default: /mnt/user/appdata/immich-power-tools/
Value: /mnt/user/appdata/immich-power-tools/

--- Immich Connection ---Variable

Connection to your Immich server.

IMMICH_URLVariable

Internal Immich server URL. Uses container name on immich_internal network.

Default: http://immich-server:2283
Value: http://immich-server:2283

IMMICH_API_KEYVariable

Immich API key with ALL permissions. Create in Immich: Account Icon → Account Settings → API Keys.

--- Database ---Variable

PostgreSQL connection. Must match your immich-vectorchord-db configuration.

DB_HOSTVariable

Database container name (must match your DB container on immich_internal).

Default: immich-vectorchord-db
Value: immich-vectorchord-db

DB_PORTVariable

Database port.

Default: 5432
Value: 5432

DB_USERNAMEVariable

Database username (must match DB container).

Default: postgres
Value: postgres

DB_PASSWORDVariable

Database password (must match DB container).

Default: postgres
Value: postgres

DB_DATABASE_NAMEVariable

Database name (must match DB container).

Default: immich
Value: immich

--- System ---Variable

General settings.

Variable: TZVariable

Timezone. See: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones#List

Target: TZ
Default: Europe/Berlin
Value: Europe/Berlin

--- Advanced (AI Search) ---Variable

Optional: Enable natural language search via AI provider (OpenAI, Ollama, etc.). No personal data is sent - only search query text.

EXTERNAL_IMMICH_URLVariable

External Immich URL for links in the Power Tools UI (e.g. https://photos.example.com). Leave empty to use IMMICH_URL.

AI_API_KEYVariable

AI provider API key for natural language search (e.g. OpenAI key).

AI_BASE_URLVariable

AI provider base URL. OpenAI: https://api.openai.com/v1, Ollama: http://host.docker.internal:11434/v1

AI_MODELVariable

AI model name. Examples: gpt-4o-mini, llama-3.1-8b-instant

Links

Template Support Registry Project

Details

Repository

ghcr.io/immich-power-tools/immich-power-tools:latest

Registry

https://github.com/immich-power-tools/immich-power-tools/pkgs/container/immich-power-tools

Last Updated2026-06-01

First Seen2026-05-27

Run immich-power-tools on Unraid.

immich-power-tools is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.

Explore Unraid OS