immich-power-tools

官方

概述

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.

要求

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/

运行时参数

网络用户界面: http://[IP]:[PORT:3000]
网络: immich_internal
外壳: sh
特权: false
额外参数: --user 99:100

模板配置

Port: Web UIPorttcp

Power Tools web interface port.

目标: 3000
默认值: 3000
价值: 3000

Path: DataPathrw

Persistent data directory for Power Tools.

目标: /app/data
默认值: /mnt/user/appdata/immich-power-tools/
价值: /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.

默认值: http://immich-server:2283
价值: 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).

默认值: immich-vectorchord-db
价值: immich-vectorchord-db

DB_PORTVariable

Database port.

默认值: 5432
价值: 5432

DB_USERNAMEVariable

Database username (must match DB container).

默认值: postgres
价值: postgres

DB_PASSWORDVariable

Database password (must match DB container).

默认值: postgres
价值: postgres

DB_DATABASE_NAMEVariable

Database name (must match DB container).

默认值: immich
价值: immich

--- System ---Variable

General settings.

Variable: TZVariable

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

目标: TZ
默认值: Europe/Berlin
价值: 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

类别

Media App > Photos Tools > Utilities

链接

模板支持登记处 Pro连接

详细信息

存储库

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

登记处

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

最后更新2026-05-31

初见2026-05-27

在Unraid 上运行 immich-power-tools 。

immich-power-tools 已被列入Unraid OS 的社区应用程序。探索Unraid ，构建灵活的家庭服务器、NAS 或家庭实验室。

探索Unraid OS