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.
Give your collection a home on supported hardware. Synology has a native app in Package Center; Unraid, TrueNAS and HexOS have their own setup guides. Check memory, processor and storage requirements first.
Unraid
Install Frameleaf Manager from the Apps tab. Choose storage with Manager using your configured appdata location, or manage the release containers yourself.
Community Apps. Read the guideSynology
Install Frameleaf Manager through Package Center. Set up your library, check services and manage database backups in a native DSM window.
Native app in Package Center. Read the guideTrueNAS
Paste the Frameleaf Manager YAML as a custom app on Community Edition 24.10 or later and name one of your pools. Choose your folders in Manager.
Custom app from YAML. Read the guideHexOS
Install Frameleaf Manager as a HexOS app. It uses your HexOS storage locations for photos, the database and backups, so the only thing you type is your Manager password.
Custom Install, app catalog coming soon. Read the guideGuided setup. Your choice of storage.
Manager checks your storage choices and guides installation, updates and database recovery. Prefer Compose? Use the files supplied together in the published release and configure your folders and password before starting.
# 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
# Choose storage paths and set a private database password
nano .env
# Start the matching release containers
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 local disk
Use a local SSD for the database, separate from network shares. Its size grows with your collection and indexes.
Room for your work
Allow space for originals, previews, edited versions, video outputs and backups. What you need depends on your formats and processing settings.
Optional GPU acceleration
Supported Intel and NVIDIA hardware can speed up compatible video and machine learning jobs. Check the guide for your device.
A second copy
Back up both the database and the complete media collection. Keep an independent copy off the server and practise restoring it.


