← Blog
explainx / blog

Immich: self-hosted photo and video library (Google Photos–class, AGPL-3)

Immich: AGPL-3 self-hosted photo & video manager (NestJS/Svelte/Flutter), ML search & faces, mobile backup—Google Photos alternative. immich.app docs.

3 min readYash Thakker
ImmichSelf-hostedPhotosOpen sourcePrivacy

MDX restores the committed source plus an HTML comment attribution; plain text bundles the rendered markdown body with the explainx.ai attribution footer.

Immich: self-hosted photo and video library (Google Photos–class, AGPL-3)

Immich is a leading open-source option for: Google Photos–style backup, albums, and search on hardware you control. The immich-app/immich monorepo combines a server API, web UI, Flutter mobile apps, and a machine-learning stack for faces, objects, and CLIP-style search—aimed at people who will trade vendor convenience for ops responsibility.

Below is a concise overview, not a substitute for docs.immich.app.

TL;DR

QuestionShort answer
What?Self-hosted photo/video library: mobile backup, web gallery, albums, map, faces, smart search
LicenseAGPL-3.0—read before commercial hosting or forking for networked services
StackNestJS server (per repo), SvelteKit web, Flutter mobile, ML container for models
DeployDocker-style stacks documented upstream (Postgres, Redis, ML service—see docs)
Your jobBackups (project README stresses 3-2-1), TLS, upgrades, storage planning
Linksimmich.app · docs.immich.app · api.immich.app

Features that matter in production

From the public README / feature matrix:

  • Mobile: auto-backup when opened, background backup, dedup, RAW, Live/Motion Photo, offline-friendly gallery patterns.
  • Library: albums, shared albums, partner sharing, public links, archive, favorites, stacked photos, folder view.
  • Discovery: timeline, global map, “memories” (on-this-day style).
  • Search: metadata; object/scene; facial recognition and clustering; CLIP semantic search where ML indexing is enabled.
  • Admin: user management and API keys are web-first in their table; mobile vs web parity for tags and some views varies—check the current matrix before promising stakeholders.

Why the architecture matters for capacity

Immich splits responsibilities like a modern cloud product, but you run every tier:

  • Core API — auth, libraries, jobs, storage layout.
  • Clients — web and mobile talk to the same API.
  • Machine learning — heavy inference (faces, embeddings, detection) off the interactive path.

Planning is not only disk: large libraries need CPU (or GPU, depending on how you run ML) for thumbnails, transcodes, and background ML queues—profile on your hardware.


AGPL-3 in practice

AGPL-3 can impose source-sharing obligations when you modify the app and let users interact over the network. Most home labs running upstream images unmodified have a different risk profile than hosting providers or white-label products. Get legal review before betting a business on a fork or a re-skinned multi-tenant Immich.


Related on ExplainX

Sources


GitHub stars, release tags, and feature matrices change often. Treat this as May 5, 2026 context and verify versions before upgrades.

Related posts