Immich-Upload-Optimizer

Immich Upload Optimizer is a proxy designed to be placed in front of the Immich server.

  • Media Applications
  • Media Servers
  • Other
  • Productivity
  • Tools & Utilities
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.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

50/100 Fair

Maintained
53last commit 201 days ago
Popular
50308 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
106 GB minimum RAM
Security check
90no serious findings, CI

Availability: platform listings confirmed today, links checked 21 days ago

GitHub stars
308
Open issues
9
Last commit
2026-05-04
Latest release
v0.5.5
License
MIT
Activity
stale

Checked 7 days ago - source: GitHub (miguelangel-nubla/immich-upload-optimizer)

Resources & Compatibility

Minimum requirements: 6 GB RAM, 2 CPU core(s).

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Fill in Immich URL and API key In your config.yaml settings file, fill in immich_url and immich_api_key before starting the kiosk. Without those required settings, the kiosk can't find your Immich photo server, so it will show no pictures. source
  • Create the kiosk folder and start it Create the ./immich-kiosk folder first, then run docker compose up -d. That gives your standalone setup the folder structure it expects and starts the kiosk in the background, so it keeps running without an open terminal. source
  • Install the Android kiosk app If you are using an Android screen, use adb (the Android command-line tool) to install ImmichFrame or Fully Kiosk Browser and launch it. If the app isn't installed first, the kiosk has no browser to show the slideshow on the screen. source

Fetched 53 days ago - each note links to its source

Alternatives (12)

  • Ente Photos - Open-source, end-to-end encrypted backup and sharing for photos and videos, with multi-platform sync, original quality, privacy controls, a…
  • Frameleaf Manager - Frameleaf Manager is the guided installer and upgrade tool for the self-hosted Frameleaf photo and video library.
  • Go-vod - Go-vod is a minimal, self-hosted video transcoding server for the Memories Nextcloud photo app that exposes stored media as HTTP Live Strea…
  • Google Photos - Cloud storage offering 15 GB free space, automatic album and duplicate organization, AI editing, cross-platform sharing, and secure backups.
  • HomeGallery - HomeGallery is a self-hosted, open-source web gallery for browsing personal photos and videos while keeping your original file and folder s…
  • PhotoPrism - PhotoPrism is a self-hosted, AI-powered photo and video manager.
  • Piwigo - Piwigo is a self-hosted, open-source photo gallery for the web that lets you publish, organise, and share your picture collection with powe…
  • Proton Drive - Emphasizes privacy with end-to-end encryption, Proton Drive safely stores, synchronizes, and shares files across devices via web and mobile…
  • TinyCld - Open source suite for mail, calendar, drive, and contacts with self-hosting, privacy, zero cost, open standards, versioned files, and unifi…
  • foldergram - Foldergram is a self-hosted, local-first web gallery that scans folders for photos and videos and displays them in a fast, Instagram-style…
  • immich-server
  • librephotos - LibrePhotos is a self-hosted, open-source photo management service for organizing and browsing photo and video collections.

Checked 40 days ago - source: AlternativeTo

Common questions

Where should Immich Upload Optimizer be placed in the request path?

It is designed to run as a proxy in front of the Immich server. It intercepts file uploads before they are stored on the Immich server.

Which external CLI programs does it use by default?

It defaults to JPEG-XL, Caesium, and HandBrake for optimizing, resizing, or compressing uploads.

Is repeated re-optimization of phone assets a reported issue?

Yes, an issue report says that immich-upload-optimizer keeps re-optimizing assets from a phone.

What proxy setting may need to be changed for larger photo and video uploads?

You may need to lift the upload size limit in your reverse proxy so larger photo and video uploads can succeed.

Answers sourced from discussion.scottibyte.com, github.com, github.com

Community

Collected 49 days ago - public community threads