Immich-Upload-Optimizer

Overview

Immich Upload Optimizer is a proxy designed to be placed in front of the Immich server. It intercepts file uploads and uses an external CLI program (by default JPEG-XL, Caesium and HandBrake) to optimize, resize, or compress images and videos before they are stored on the Immich server. This helps save storage space on the Immich server by reducing the size of uploaded files.

Requirements

Expects a `tasks.yaml` file in the Tasks Config Path folder. See documentation: https://github.com/miguelangel-nubla/immich-upload-optimizer/blob/main/TASKS.md

Runtime arguments

Network: bridge
Privileged: false

Template configuration

Proxy PortPorttcp

Container Port: 2283

Target: 2283
Default: 2283
Value: 2283

Immich Server URLVariable

URL of the Immich server

Target: IUO_UPSTREAM
Default: http://IMMICH_SERVER_IP:2283
Value: http://IMMICH_SERVER_IP:2283

Tasks Config PathPath

Path to a folder containing the tasks config file

Target: /config
Default: /mnt/user/appdata/immich-upload-optimizer/config
Value: /mnt/user/appdata/immich-upload-optimizer/config

Internal Task File PathVariable

Path to the tasks config file inside the container. Not recommended to change.

Target: IUO_TASKS_FILE
Default: /config/tasks.yaml
Value: /config/tasks.yaml

Internal Listen AddressVariable

Address to listen on inside the container. Not recommended to change.

Target: IUO_LISTEN
Default: :2283
Value: :2283

Links

Template Support GHCR Project

Details

Repository

ghcr.io/miguelangel-nubla/immich-upload-optimizer:latest

Registry

https://registry.hub.docker.com/r/ghcr.io/miguelangel-nubla/immich-upload-optimizer

Last Updated2026-06-02

First Seen2025-03-31

Run Immich-Upload-Optimizer on Unraid.

Immich-Upload-Optimizer is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.

Explore Unraid OS