Frameleaf

Your photos. Your server. Everywhere.
A self-hosted photo and video library: bring a lifetime of photos home, find any moment, edit it, and enjoy it on your phone, in any browser and on the TV.

Website · Docs · Install · Features · Ask Frameleaf · FAQ

[!WARNING] Frameleaf is in BETA testing and under heavy development. Expect bugs, breaking changes and incomplete features. Keep independent backups of your photos and videos, and don't rely on Frameleaf as the only copy of your library.

What is Frameleaf?

Frameleaf runs on your NAS, home server or any Linux machine with Docker. Your originals stay as ordinary files on your own disks, faces and search are worked out on your own hardware, and there's no telemetry. No subscription or cloud account required.

One library, every screen:

• Server and web app — the Frameleaf Library and its API (open source, AGPLv3).
• iPhone and iPad — native app with backup, a built-in editor, widgets, Siri and Live Activities.
• iPhone Duo — fold-aware layouts, Compare, Frame mode and multiple windows.
• Android — native app with backup, offline library, editor and Google Cast.
• Apple TV — browse, play memories as shows, and turn your TV into a photo frame.
• Frameleaf Cloud (optional) — encrypted remote access, off-site backup and cloud GPU processing.

➡️ Read more in What is Frameleaf? or the full features overview.

Features

Search — describe what you remember	People & pets — recognised on your own hardware
Memories — moments resurfaced	Places — your photos on a world map
Photo editor — masks, looks and saved versions	Best photos — your strongest shots, ranked privately
Command Center — your server at a glance	Backups — local, Cloud and Buddy backup

Studio

A real video editor inside your photo library: titles, video, camera audio and music on their own tracks, colour wheels and scopes, timed captions from speech, and restoration for old footage — rendered on your own hardware.

Timeline editing	Colour grading
Captions from speech	Restoration

Apps

iPhone, iPad and Android

Back up your camera roll to your own server, check every photo arrived safely, free up space, and carry your whole library with you — at home, away or offline. Sign in with Frameleaf, find servers on your Wi-Fi automatically, or set up a brand-new server straight from your phone.

iPhone and iPad (iOS 26+) · Android (Android 11+)

iPhone Duo

Frameleaf reads the fold and lays your library out around it: open it like a book to see a photo beside the grid or compare two photos, prop it up to edit, turn any album into a desk photo frame with Frame, and drag photos between two windows.

Library — grid and photo side by side

Editor — photo above the fold, controls below

iPhone Duo and wide windows

Apple TV

Your memories on the biggest screen in the house. Browse Home, Memories, Places, Albums, People and Search from the couch, play memories as shows with title cards and music, or leave a slideshow running as a photo frame. Pick something on your iPhone and choose Play on Apple TV.

Home — favourites, best photos, memories and places	Memories — played as shows
People — everyone, on the big screen	Slideshow — your TV as a photo frame

Apple TV (tvOS 26+, uses Frameleaf Cloud remote access)

Get started

1. Check the requirements — Linux with Docker and Docker Compose v2. Not sure what your GPU can run? Ask Frameleaf or see Choose processing for your hardware.
2. Install with one of:
   • Frameleaf Manager — guided install and upgrades (recommended).
   • Docker Compose — for experienced administrators.
   • NAS apps — Unraid, Synology and TrueNAS.
3. Open http://<server-ip>:2283, or set the server up from the iPhone or Android app on the same Wi-Fi, then follow First steps after installing.

Quick start with Docker Compose

mkdir frameleaf-app && cd frameleaf-app
curl -fL -o docker-compose.yml https://github.com/Frameleaf/frameleaf-app/releases/latest/download/docker-compose.yml
curl -fL -o .env https://github.com/Frameleaf/frameleaf-app/releases/latest/download/example.env
docker compose up -d

Edit .env first if you want your photos (UPLOAD_LOCATION) or database (DB_DATA_LOCATION) somewhere other than the current folder. To upgrade later, run docker compose pull && docker compose up -d — see Upgrading.

[!TIP] Your library on one server is a single copy. Protect it with Cloud backup, Buddy backup or your own copies — see Backup and restore.

Switching from another service?

• Switch from your existing photo server
• Import from iCloud Photos or keep iCloud Photos in sync
• Import from Google Photos
• Import from a folder or another app

Frameleaf Cloud (optional)

Self-hosting is free. Frameleaf Cloud adds:

• 🌐 Remote access — encrypted access from anywhere, for the apps and Apple TV
• ☁️ Cloud backup — off-site backup
• ⚡ Cloud GPU — run heavy AI jobs without local hardware

A Server licence on its own gives your server a Frameleaf direct address for remote access, and lets it trade backups with a friend's licensed server through Buddy backup over a direct connection; Frameleaf Cloud adds the relay when a direct connection isn't possible. See frameleaf.app for current pricing.

Docs and help

The Frameleaf docs and help center cover everything from first install to the API.

License

The Frameleaf Library server is open source under the GNU AGPLv3.