Watch frameleaf-server video

Full app details

Watch frameleaf-server video

frameleaf-server

Full app details Watch on YouTube

frameleaf-server

Docker app from Frameleaf's Repository

Overview

A home for your photos and videos on hardware you own. Browse a timeline, organise albums and folders, explore people and places, edit photos, and share selected memories with family. Add the separate Machine Learning container for local smart search and recognition. This is the application server for a manual Docker installation. It provides the Frameleaf web app and the APIs used by Frameleaf clients. New to self-hosting? Install Frameleaf Manager instead for guided storage setup, release management and database recovery. Before starting, create a fresh Frameleaf PostgreSQL 19 database on the frameleaf network, configure matching database credentials, and map persistent library storage. A container image change does not convert an existing database. Back up both the database and original media before updating. The self-hosted library needs no Cloud account; optional Cloud services are separate.

Media gallery

1 / 3

Requirements

A fresh Frameleaf PostgreSQL 19 database using the matching release image and credentials; the frameleaf Docker network; persistent media storage. Optional local search and recognition require the separate frameleaf-ml container. See the Unraid installation guide.

Categories

Media App > Photos

Related apps

Explore more like this

Links

Projectframeleaf.app Supportframeleaf.app Registrygithub.com Templateraw.githubusercontent.com

Details

Repository

ghcr.io/frameleaf/frameleaf-server:latest

Registry

https://github.com/orgs/Frameleaf/packages/container/package/frameleaf-server

Last Updated2026-11-11

First Seen2026-11-11

Runtime arguments

Web UI: http://[IP]:[PORT:2283]
Network: frameleaf
Shell: sh
Privileged: false
Extra Params: --stop-timeout=10 --shm-size=2g

Template configuration

Web portPorttcp

Frameleaf web interface

Target: 2283
Default: 2283
Value: 2283

LibraryPathrw

Persistent original media and generated files; back up with the database

Target: /data
Default: /mnt/user/appdata/frameleaf/library
Value: /mnt/user/appdata/frameleaf/library

Studio worker enrolmentPathrw

Private folder the server writes the bundled Studio render worker's enrolment to; frameleaf-ml mounts the same folder read-only

Target: /run/frameleaf/studio-worker
Default: /mnt/user/appdata/frameleaf/studio-worker
Value: /mnt/user/appdata/frameleaf/studio-worker

Database hostVariable

PostgreSQL 19 container name on the frameleaf network

Target: DB_HOSTNAME
Default: frameleaf-postgres
Value: frameleaf-postgres

Database nameVariable

Database name

Target: DB_DATABASE_NAME
Default: frameleaf
Value: frameleaf

Database userVariable

PostgreSQL user

Target: DB_USERNAME
Default: frameleaf
Value: frameleaf

Database passwordVariable

Use the same generated secret configured in PostgreSQL

Target: DB_PASSWORD

Machine learningVariable

Set false when no ML service is installed; leave blank for local, custom or remote ML

Target: FRAMELEAF_MACHINE_LEARNING_ENABLED

Machine learning URLVariable

Optional ML container on the frameleaf network

Target: FRAMELEAF_MACHINE_LEARNING_URL
Default: http://frameleaf-ml:3003
Value: http://frameleaf-ml:3003