Get Frameleaf.

Give your photos a home on your own hardware. Start with the installation guide, choose your storage and connect the devices you want to use.

On Synology, follow the released Synology SPK installation guide. Standalone Frameleaf Manager is released for Linux amd64 and arm64, with Unraid, TrueNAS and HexOS install files. Follow the Manager install guide; Manager and the photo application have separate releases. See the platform guides for app installation and compatibility.

1. Install the server.

On Synology, download the approved SPK and install it with Package Center → Manual Install. On a supported Linux Docker host, use the Manager launcher. Both guide storage, library installation, updates and database recovery.

Frameleaf Manager

The primary setup path. Choose your storage, install a verified release, and manage your server from a separate web interface.

Install guide

Unraid

Install Frameleaf from Community Apps: open the Apps tab and search for Frameleaf. It uses your configured appdata storage. Manual Compose setup is also documented.

Unraid guide

Synology

A native DSM app installed with the approved SPK through Package Center → Manual Install. Set up your library and manage services, storage and database backups from your DiskStation.

Synology SPK guide

TrueNAS

Install Manager as a Custom App via YAML on TrueNAS 24.10.2.2 or later.

TrueNAS guide

2. Make it yours.

On Synology, open Frameleaf Manager from the DSM main menu while signed in as a DSM administrator. Create your separate Manager administrator with a name and password; no claim key is required. On standalone hosts, follow the Manager guide and create the administrator from your home network; no claim key is required. Choose the matching signed photo application release in Manager. Once installed, open Frameleaf and finish its own setup: your account, processing choices and first import.

  • Private administration. Keep Manager on your trusted network. Its login stays available when the photo application is stopped.
  • Local by default. Choose a local account and local processing, with no Frameleaf Cloud link unless you want one.
  • Bring your collection. Add existing folders or a Google Takeout export. The new iCloud import needs server setup and a connected Apple account.
First-run setup: bring everything in

3. Get the app.

The native iPhone and Android apps connect to your library's address. Choose which albums to back up, review progress and keep selected media for offline use. Away from home, your server needs a working remote-access connection; a Frameleaf account alone doesn't make it reachable.

Download on the App StoreGet it on Google Play

Choose your platform guide for installation and requirements.

About the apps
Welcome screen on iPhone
Library on Android

Want remote access and backup?

Explore optional Frameleaf Cloud services for reaching your server and keeping another copy. Your local library works independently.

Common questions

Search all answers · Browse the full FAQ