User Guide
Welcome to the LibrePhotos user guide. These pages walk you through everyday use of your photo library, from your first login through organizing, sharing, and administering your collection. If you have not installed LibrePhotos yet, start with the Installation section first.
New here? Begin with First steps.
Getting started
- First steps — what to do right after your first login.
- Viewing photos — photo views, the lightbox, and the photo details sidebar.
- Upload — adding photos through the web interface.
- Search — finding photos with spotlight, semantic, and text search.
Organizing your photos
- Albums — creating and managing photo albums.
- Places — how geolocation and the places map work.
- Face recognition — training and using the face dashboard.
- Image captioning — automatic captions for your photos.
- Stacks & file variants — how RAW+JPEG pairs, Live Photos, and bursts are grouped.
- Sharing — sharing photos and albums with other users or via public links.
Managing your library
- Library management — scanning, Nextcloud integration, and server management.
- Auto scan all folders — scanning every folder automatically.
- Missing photos — understanding and clearing missing photos.
- Duplicate detection — finding and managing duplicate photos.
- Trash — how the trash works.
- Statistics & data visualization — interactive visualizations of your library.
Files & metadata
- Exif data — which EXIF fields LibrePhotos reads, writes, and filters on.
- Internal files — a tour of the folders and files LibrePhotos keeps on disk.
Administration
- Settings — where the settings live and what they control.
- Manage multiple users — adding and managing additional user accounts.
- Feature toggles — turning individual features on and off.
- Job system — what the background worker jobs and logs mean.
- Offline usage — running LibrePhotos without an internet connection.
- API authentication — authenticating against the API with JWT or Basic auth.
Mobile
- Mobile apps — the companion mobile apps for LibrePhotos.
Reference
- Feature comparison — how LibrePhotos compares with other photo managers.
- FAQ — answers to common questions and problems.