ImmichFrame

v1.0.36.0 Breaking

This release includes 1 breaking change for platform teams planning a safe upgrade.

Published 13d Media Servers

View tool

✓ No known CVEs patched

Read the diff → Tool health → What is this tool? →

✓ No known CVEs patched in this version

Topics

asp-net-core c# digital-photo-frame docker .net immich

+5 more

immich-slideshow immichframe photoframe svelte sveltekit

Affected surfaces

auth breaking_upgrade

ReleasePort's take

Moderate signal

editorial:auto 12d

Starting with v1.0.36.0 Immich enforces version v3 at launch and aborts if a server is incompatible; it also logs each configured server’s version on startup.

Why it matters: Enforcement of Immich v3 at startup causes immediate failure on mismatched servers—a measurable trigger for operators to verify compatibility before launch. Logging versions aids debugging of version‑related issues.

Summary

AI summary

Updates ✨ New Features, 🔨 Maintenance, and older across a mixed release.

Changes in this release

Type	Severity	Summary	CVE
Breaking	High	Enforces Immich v3 at startup; fails fast on incompatible servers. Enforces Immich v3 at startup; fails fast on incompatible servers. Source: llm_adapter@2026-07-14 Confidence: high	—
Feature	Medium	Logs version of each configured Immich server at startup. Logs version of each configured Immich server at startup. Source: llm_adapter@2026-07-14 Confidence: high	—
Refactor	Low	Splits settings into dedicated client and server interfaces; restricts /api/Config to client‑safe values. Splits settings into dedicated client and server interfaces; restricts /api/Config to client‑safe values. Source: llm_adapter@2026-07-14 Confidence: high	—

Full changelog

📦 ImmichFrame Release v1.0.36.0 – July 14, 2026

This release adds a startup guard that fails fast when ImmichFrame is pointed at an incompatible Immich server, logs each server's version, and cleans up how settings are handled internally.

What's Changed

✨ New Features

🚦 Startup version check enforces Immich v3

PR #676 by @JW-CH

ImmichFrame already targets the Immich v3 API — this release now enforces it at startup. On boot, it checks the version of every configured Immich server and refuses to start if any server is older than v3, is unreachable, or its version can't be determined. Previously, an incompatible (older) server would let ImmichFrame start but then fail later with a cryptic
deserialization error — for example, Immich changed an asset's duration from a string like "0:00:00.00000" to integer milliseconds, which broke image loading. Now you get a clear critical log message naming the affected server, and the container stops instead of silently misbehaving.

What you need to do: Make sure your Immich server(s) are on v3.0 or newer. If ImmichFrame won't start, check the logs for the offending server.

💡 Tip: In Docker, pair this with a restart policy (e.g. restart: unless-stopped) so ImmichFrame retries automatically if an Immich server is still coming up during boot.

The bundled Immich OpenAPI spec was also bumped to 3.0.2 as part of this change.

📋 Immich server version logging

PR #673 by @JW-CH

ImmichFrame now logs the version of each configured Immich server at startup, so you can confirm compatibility at a glance. Previous startup log noise was trimmed at the same time, making the logs easier to read.

🔨 Maintenance

🔧 Simplified settings handling

PR #667 by @JW-CH

Settings are now split into dedicated client and server interfaces. As a result, the /api/Config endpoint is structurally limited to client-safe values only — server-only secrets such as API keys, the webhook URL, the authentication secret, and web-calendar URLs can no longer reach the client. This change also makes the per-account asset tracker (BloomFilter) thread-safe and reworks how the account-selection strategy is constructed for more reliable multi-account setups.

Full Changelog: https://github.com/immichFrame/ImmichFrame/compare/v1.0.35.0...v1.0.36.0

Breaking Changes

Requires all configured Immich servers to be version 3.0 or newer; startup fails fast on incompatible versions.

View diff on GitHub

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

Share this release

Share on X Share on Bluesky

Track ImmichFrame

Get notified when new releases ship.

About ImmichFrame

An awesome way to display your photos as a digital photo frame

All releases →