Skip to main content
Gumnut’s Immich compatibility layer supports most of the core Immich functionality. This page covers what’s supported, what isn’t, and how Gumnut differs from the official Immich server.

​
Supported Immich Version

The compatibility layer currently targets the Immich v3.0.3 API. It is v3-only rather than a dual-version adapter, so use a current Immich v3 app when connecting to Gumnut.

​
Supported Features

These Immich features work with Gumnut:

​
Not Yet Supported

These Immich features are not currently available through Gumnut. Some may be added in the future:
Most features listed as “not yet supported” return empty results in the Immich apps — they won’t cause errors, but the corresponding sections will appear empty.
Two entries behave differently. Selecting several assets and choosing Download appears to start but produces no file and no error — download assets individually in the Immich apps, or fetch them through the API, until bulk download is supported. Saving or hiding a memory also appears to succeed, then reverts the next time the carousel loads.
The map view works for assets that already have GPS coordinates, including maps opened from an album. Immich’s Explore view can show Places grouped by city when your assets include location data. Recent photos appears independently. You can change an asset’s location by dropping a pin on the map; the place-name box in that dialog returns no results.

​
Intentionally Different

Some features work differently in Gumnut by design:
  • Camera and place search ranks rather than filters — Immich presents camera make, model, and lens, and city, state, and country as filters. Gumnut matches them as search terms instead, so results are ordered by how well they match rather than restricted to exact matches: searching for Canon surfaces your Canon photos first but can include others. Combining one of these terms with your own search text can also dilute that text, since the terms are matched alongside it rather than narrowing it. Exact filtering isn’t available yet.
  • No external libraries — Immich allows importing photos from external file paths on the server. Gumnut does not support this because it runs as a managed cloud service, not on your local machine. You always have full access to your original assets and metadata through the API.
  • No admin-level ML configuration — Immich lets you customize embedding models, ML processing settings, and other server-level options. Gumnut manages these automatically — you get the latest models and optimizations without configuration.
  • Automatic face grouping into people — Gumnut uses a more sophisticated recognition pipeline than Immich’s per-face matching, with crowd-face filtering, library-wide re-clustering, and sibling-aware matching. See Faces and People for details.
  • CDN delivery instead of home-server serving — A self-hosted Immich server serves photos directly from your home machine and network, which is limited by your home upload bandwidth and requires exposing the server to the internet. Gumnut delivers your photos through Cloudflare’s global CDN backed by cloud storage, so they load quickly from anywhere without those constraints.
  • No server administration — Immich exposes admin endpoints for managing users, jobs, and system settings. Gumnut handles infrastructure and administration automatically.
  • API keys are managed in Gumnut, not Immich — Immich’s API Keys settings page doesn’t create working keys. Create and revoke keys in the Gumnut dashboard instead; see API Keys.

​
Gumnut vs Official Immich Server