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

Objetivo

8080

Por defecto

8080

Valor

8080

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

Objetivo

/app/appdata

Por defecto

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

Valor

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

Objetivo

SECRET_KEY

Por defecto

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

Valor

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

Objetivo

TZ

Por defecto

America/New_York

Valor

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.

Por defecto

99

Valor

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.

Por defecto

100

Valor

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.

Objetivo

CLEANUP_CACHE

Por defecto

false

Valor

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.

Objetivo

CACHE_PATH

Por defecto

/app/appdata/cache

Valor

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

Objetivo

BATCH_SIZE_MB

Por defecto

10240

Valor

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.

Objetivo

BATCH_FILE_COUNT

Por defecto

0

Valor

0

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

Objetivo

LOG_PATH

Por defecto

/app/appdata/logs/sync.log

Valor

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

Objetivo

DB_PATH

Por defecto

/app/appdata/config.db

Valor

/app/appdata/config.db