Immich Digital Photo Frame on Android: Setup Guide

Immich digital photo frame on Android

Updated August 9, 2026 ยท 8 min read

Immich is a self-hosted photo and video management server โ€” essentially a private Google Photos that runs on hardware you own. If you already have Immich running, you can use it as the photo source for an Android digital photo frame without sending your photos to any external service. The frame pulls directly from your Immich server, caches photos locally, and runs the slideshow entirely on your network.

Why Immich is ideal for a self-hosted photo frame

What you need before connecting

Setup: what the onboarding covers

When you first launch Fravora, the onboarding guides you through connecting your first source. Here is what it covers for an Immich connection:

  1. Choose Immich as your source type.
  2. Enter your Immich server URL. For a local server this is typically http://192.168.x.x:2283 or http://immich.local:2283. For an externally accessible server, use your domain with HTTPS.
  3. Paste your Immich API key into the API Key field.
  4. Tap Test Connection. Fravora contacts your server, verifies the key, and confirms access before saving.
  5. The album picker opens. Select the Immich album or albums you want displayed on the frame.
  6. Name your slideshow album and assign the Immich source to it. The frame begins downloading and displaying your photos โ€” setup is done.

To add more Immich connections or other source types later, go to Settings โ†’ Sources.

How to generate an Immich API key

  1. Open your Immich web interface and log in.
  2. Click your avatar in the top-right corner and go to Account Settings.
  3. Scroll to the API Keys section and click New API Key.
  4. Give it a name (e.g. "Photo Frame") and copy the generated key. You will only see the key once โ€” paste it into Fravora immediately.

Caching and offline behaviour

Fravora caches downloaded Immich photos on the device using the standard image cache (configurable from 128 MB to 2 GB). Once a photo is cached, it displays without contacting the server. This means short network outages โ€” a router reboot, a NAS going to sleep, a brief Wi-Fi drop โ€” do not interrupt the slideshow. The frame picks up new photos from Immich on the next scheduled scan.

Mixing Immich with other sources

Immich does not have to be your only photo source. A single Fravora album can combine Immich album targets with local device folders, NAS/SMB shares, Google Photos picks, OneDrive folders, and Dropbox folders. All sources rotate together in the slideshow. A common setup for self-hosters is Immich for recently imported photos plus a NAS SMB share for the older organised archive โ€” both playing from the same frame.

Recommended album strategy

Rather than pointing the frame at your entire Immich library, create a dedicated Frame album in Immich and curate it. Add photos you want displayed, remove ones you do not. This keeps the slideshow intentional โ€” not a raw dump of every camera import โ€” and makes it easy to update what the frame shows without touching the frame app itself. You can add more albums from Immich as additional sources within the same Fravora album if you want broader coverage.

Common Immich server setups that work

Synology NAS with Docker: Run Immich in Docker Compose on a Synology NAS. The frame connects via the NAS local IP and the Immich port. This is one of the most popular self-hosting setups and works reliably on the local network.

QNAP with Container Station: Similar to Synology โ€” deploy Immich containers via Container Station and connect via local IP.

TrueNAS SCALE: Immich can be deployed as a TrueNAS application. The frame connects via the TrueNAS host IP and Immich's port.

Raspberry Pi or home server: A bare-metal Linux server running Immich works the same way. Use the server's local IP address as the connection URL.

VPS with a public domain: If your Immich server is accessible on the internet via a domain with HTTPS, the frame can connect from anywhere โ€” useful if the frame is on a different network from the server, such as a frame at a relative's house showing your photos.

Troubleshooting connection issues

Test Connection fails: Double-check the URL format โ€” include the port number if Immich is not on port 80 or 443. Confirm the API key was copied correctly with no trailing spaces. If your server uses a self-signed certificate, make sure the Android device trusts it or use HTTP on a local network.

Photos not appearing: Confirm the selected albums contain photos and the API key user has access to those albums. In Immich, album visibility is per-user โ€” the API key inherits the permissions of the account it belongs to.

โ† Back to Blog