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

Ziel

8080

Standard

8080

Wert

8080

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

Ziel

/app/appdata

Standard

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

Wert

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

Ziel

SECRET_KEY

Standard

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

Wert

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

Ziel

TZ

Standard

America/New_York

Wert

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.

Standard

99

Wert

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.

Standard

100

Wert

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.

Ziel

CLEANUP_CACHE

Standard

false

Wert

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.

Ziel

CACHE_PATH

Standard

/app/appdata/cache

Wert

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

Ziel

BATCH_SIZE_MB

Standard

10240

Wert

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.

Ziel

BATCH_FILE_COUNT

Standard

0

Wert

0

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

Ziel

LOG_PATH

Standard

/app/appdata/logs/sync.log

Wert

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

Ziel

DB_PATH

Standard

/app/appdata/config.db

Wert

/app/appdata/config.db