> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gumnut.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Immich Overview

> Use Immich apps and tools with Gumnut's AI-powered photo platform

[Immich](https://immich.app) is a popular open-source, self-hosted photo and video management platform with polished web and mobile apps. Gumnut provides an Immich API compatibility layer, so you can use the Immich mobile and web apps with your Gumnut photo library.

This is powered by [immich-adapter](https://github.com/gumnut-ai/immich-adapter), an open-source reverse proxy that translates Immich API calls into Gumnut API calls. Gumnut runs this for you — you don't need to deploy it yourself.

## Getting Started

You can access your Gumnut library through the Immich apps right away:

* **Web app** — Browse your library at [immich.gumnut.ai](https://immich.gumnut.ai)
* **iOS app** — Download from the [App Store](https://get.immich.app/ios), set the server URL to `https://immich.gumnut.ai`
* **Android app** — Download from [Google Play](https://get.immich.app/android), set the server URL to `https://immich.gumnut.ai`

Log in with your Gumnut credentials. The mobile app supports [automatic background backup](https://docs.immich.app/features/mobile-backup) of your camera roll.

## Why Use Gumnut with Immich

Gumnut is an AI-powered photo platform that gives you the familiar Immich experience plus capabilities that aren't available with a standard Immich server:

* **MCP server and MCP App** — Connect AI assistants like Claude, Cursor, and ChatGPT directly to your photo library. The [MCP App](/guides/mcp/overview#mcp-apps) provides a rich interactive UI for browsing and managing photos within MCP-compatible clients.
* **AI description generation** — Gumnut automatically generates searchable descriptions of your photos using vision language models
* **More accurate face detection and people grouping** — Gumnut's recognition pipeline goes beyond Immich's per-face matching for cleaner, more accurate people groups. See [Faces and People](/guides/immich/faces-and-people) for details.
* **Fast image serving from a global CDN** — Gumnut serves your photos through Cloudflare's global CDN backed by S3-compatible cloud storage, so they load quickly from anywhere — without the upload-bandwidth limits or internet exposure of serving from a home server.
* **Full API access** — A [REST API](/guides/apis/overview), [TypeScript](/guides/sdks/typescript) and [Python](/guides/sdks/python) SDKs, and [webhooks](/guides/apis/webhooks) for building custom workflows

If you're already familiar with Immich, Gumnut lets you keep using the apps and workflows you know while gaining access to these additional capabilities.

## Gumnut Is Not a Hosted Immich Provider

Gumnut is an AI photo platform with Immich compatibility — not a hosted version of the Immich server. The Immich apps connect to Gumnut's own backend through the compatibility layer, and some Immich features [work differently or aren't available](/guides/immich/compatibility).

Immich is built to be self-hosted: you run the server software yourself, on your own hardware or a server you rent. That gives you more control and privacy, but it also makes you responsible for the initial setup and for ongoing maintenance over time — storage, backups, security, and software updates. It's a good fit if you're technically inclined and want to run your own infrastructure. Letting a cloud provider like Gumnut host instead trades some of that control for convenience: there's nothing to set up or maintain, and your library is available from anywhere.

If you're looking for a hosted Immich server that runs the official Immich software, consider these providers. None of these providers are associated with or vetted by Gumnut.

* [PikaPods](https://www.pikapods.com/) — Instant open-source app hosting with weekly updates and encrypted backups
* [Elestio](https://elest.io/open-source/immich) — Fully managed Immich on dedicated VMs across multiple cloud providers
* [ElfHosted](https://elfhosted.com/app/immich/) — Managed Immich hosting with bring-your-own storage
* [Cloudron](https://www.cloudron.io/) — Self-hosted app platform with one-click Immich installation
* [PeakNetworks](https://www.peaknetworks.com/server-cloud/hosting/immich) — European hosting with data centers in Switzerland, Germany, and Austria
* [Yundera](https://www.yundera.com/) — Private cloud server with one-click app installs including Immich

## Contributing

The immich-adapter is open source. If you'd like to contribute to improving Immich compatibility, visit the [immich-adapter repository](https://github.com/gumnut-ai/immich-adapter) on GitHub.