Immich API Key Permissions for EspFrame
EspFrame needs a read-only API key; it never modifies or uploads. Account Settings → API Keys → New API Key in Immich. Deselect all, then enable only:
Recommended permissions
| Permission | Why |
|---|---|
asset.read | Search for random photos and read metadata (date, location, EXIF) |
asset.statistics | Count matching photos for album, person, and tag sources |
asset.view | Download photo thumbnails for display |
person.read | Show people's names on the photo overlay |
album.read | Album names a photo belongs to |
tag.read | Tags assigned to photos |
map.read | Additional GPS/map data beyond EXIF |
memory.read | Read Immich On This Day Memories |
Next steps
After creating the key, add the Immich server URL and paste this key in the frame’s web UI (or during Install). The URL can use http:// or https://, and can be either an IP address or a domain name, for example http://192.168.1.30:2283 or https://photos.example.com. Then configure Filters and Memories and your photos will start loading.
