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

Target

8080

Default

8080

Value

8080

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

Target

/app/appdata

Default

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

Value

/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.

Target

SECRET_KEY

Default

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

Value

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

Target

TZ

Default

America/New_York

Value

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.

Default

99

Value

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.

Default

100

Value

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.

Target

CLEANUP_CACHE

Default

false

Value

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.

Target

CACHE_PATH

Default

/app/appdata/cache

Value

/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).

Target

BATCH_SIZE_MB

Default

10240

Value

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.

Target

BATCH_FILE_COUNT

Default

0

Value

0

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

Target

LOG_PATH

Default

/app/appdata/logs/sync.log

Value

/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.

Target

DB_PATH

Default

/app/appdata/config.db

Value

/app/appdata/config.db