Port for the Immich Album Sync web interface. Open this in your browser after the container starts.

目标

8080

默认值

8080

价值

8080

Persistent storage for the database (config.db), download cache, and sync logs. Map to a location on your array.

目标

/app/appdata

默认值

/mnt/user/appdata/immich-album-sync

价值

/mnt/user/appdata/immich-album-sync

REQUIRED: Change to a unique random string used to sign session cookies and encrypt stored API keys. Using the default value is INSECURE. Key length: minimum 16 characters | recommended 32–64 characters | maximum 128 characters (longer values provide no extra security). Generate a strong key at: https://1password.com/password-generator/ — select 32–64 characters, all character types. WARNING: changing this key after initial setup will invalidate all stored API keys and log out all active sessions — you will need to re-enter API keys for every sync job.

目标

SECRET_KEY

默认值

change-me-please-use-a-long-random-string-here

价值

change-me-please-use-a-long-random-string-here

Container timezone. Used for log timestamps. Examples: America/New_York, America/Chicago, America/Los_Angeles, Europe/London, UTC. Full list: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones

目标

TZ

默认值

America/New_York

价值

America/New_York

User ID the app process runs as (the container no longer runs as root). The default 99 is Unraid's 'nobody' user, which matches standard appdata ownership — leave it unless your appdata/cache is owned by a different user. If the container logs permission errors writing to appdata, set this to the owner UID of your appdata share.

默认值

99

价值

99

Group ID the app process runs as. The default 100 is Unraid's 'users' group, which matches standard appdata ownership. Change only if your appdata/cache is owned by a different group.

默认值

100

价值

100

Set to 'true' to automatically delete downloaded originals from the cache directory after they have been successfully uploaded. Saves disk space but files will be re-downloaded on the next sync run. Can also be toggled per-job in the Web UI.

目标

CLEANUP_CACHE

默认值

false

价值

false

Path inside the container where original files are temporarily staged before uploading to the destination server. The default stores the cache inside the App Data directory. To store the cache on a different disk, SSD pool, or network share (recommended for large first-time syncs): 1. In the Docker template, add a second Path mapping: Container path: /app/cache Host path: /mnt/user/YourDisk/immich-sync-cache (or any writable path) 2. Set this field to: /app/cache This lets you route multi-GB or multi-TB downloads to a large array disk or NAS share without filling your primary Unraid cache pool. The container must have write access to whatever path you choose.

目标

CACHE_PATH

默认值

/app/appdata/cache

价值

/app/appdata/cache

Maximum amount of data (in megabytes) to download before uploading a batch to the destination server. After each batch is uploaded it is cleared from the cache, then the next batch begins. This prevents the local cache from growing too large during first-time syncs of very large albums. Default: 10240 (10 GB). Set to 0 to download all files before uploading (disables size-based batching).

目标

BATCH_SIZE_MB

默认值

10240

价值

10240

Maximum number of files to stage per batch before uploading. Works alongside Max Cache Batch Size — whichever limit is reached first triggers an upload cycle. Default: 0 (no file-count limit; only the size limit applies). Example: set to 500 to process albums in groups of 500 files regardless of total size.

目标

BATCH_FILE_COUNT

默认值

0

价值

0

Internal path for the sync log file. Viewable live in the Web UI under 'Live Logs'. Leave blank to use the default.

目标

LOG_PATH

默认值

/app/appdata/logs/sync.log

价值

/app/appdata/logs/sync.log

Internal path for the SQLite database that stores sync job configurations and run history. Leave blank to use the default.

目标

DB_PATH

默认值

/app/appdata/config.db

价值

/app/appdata/config.db