The box under the desk, now a photo library.
Your NAS already holds your files. Frameleaf turns it into a home for every photo and video, with apps for every phone in the house.
Runs on the NAS you already own.
Frameleaf is a set of containers. If your box runs Docker, it runs Frameleaf. Step-by-step guides cover the three most popular NAS systems.
Unraid
Add a Frameleaf stack, paste the release Compose file and point it at a share for your photos.
Docker Compose Manager plugin. Read the guideSynology
Create a project in Container Manager from the Frameleaf Compose file. Your library lives in a shared folder.
Container Manager in DSM. Read the guideTrueNAS
Create datasets for photos and the database, then install the Frameleaf Compose file as a custom app on Community Edition 24.10 or later.
Custom app from YAML. Read the guideOr any Linux box with Docker.
Three commands from an empty folder to a running library. You need 6 GB of RAM and two CPU cores, on amd64 or arm64.
# Get the Compose file and settings from the latest release
wget -O docker-compose.yml https://github.com/Frameleaf/frameleaf-app/releases/latest/download/docker-compose.yml
wget -O .env https://github.com/Frameleaf/frameleaf-app/releases/latest/download/example.env
# Start Frameleaf in the background
docker compose up -dWhat to plan for.
Memory
6 GB minimum, 8 GB recommended. With 4 GB, run without machine learning.
Processor
Two cores minimum, four recommended. amd64 or arm64.
Database on SSD
Keep the Postgres folder on a local SSD, never a network share. It's usually 1 to 3 GB.
Room to grow
Thumbnails and video previews add about 10 to 20% to your library's size.
GPU, if you have one
Intel iGPU and NVIDIA cards speed up video transcoding and machine learning.
Off-site copy
A NAS isn't a backup by itself. Add cloud backup or a buddy's server.