# LibrePhotos

> A self-hosted photo library that sorts photos by face, place and day.

- Page: https://cgt.octabyte.io/templates/librephotos/
- Category: Files & photos
- Replaces: Google Photos and iCloud Photos
- Ease of use: Some setup. Sign in as admin with the password Cloudgate shows you, set your photo folder, then upload photos and LibrePhotos sorts them.
- App price: Free. To run it you need Cloudgate (hosted, or free to install yourself) and a server, which hosted Cloudgate can provide.
- License: MIT
- Good for: Households and photographers who want a photo collection sorted by face, place and event automatically
- Official website: https://docs.librephotos.com
- Documentation: https://docs.librephotos.com/docs/intro
- Source code: https://github.com/LibrePhotos/librephotos
- Last updated: 2026-11-20

## What is LibrePhotos?

LibrePhotos is a self-hosted photo library that sorts your photos by face, place and day, and finds them by plain-word search, like Google Photos.

LibrePhotos is a free, open-source, self-hosted photo library and an alternative to Google Photos and iCloud Photos: it keeps your photos and videos on your own server and sorts them by face, place and day. It recognises the people in your pictures, puts them on a map, makes albums from days out and lets you search in plain words such as "dog on a beach". All of this runs on your server's own processor, so your pictures are not sent to an outside service.

A family could, for example, gather twenty years of photos in one place, name each grandparent once, and then open every picture of them in a click, or find last summer's trip on the map. Several people can each have their own account, share albums with one another, or send a public link to friends.

LibrePhotos works in any web browser and keeps RAW camera files, videos and Live Photos alongside ordinary pictures. If you are leaving Google Photos, it reads a Google Takeout download with dates and places intact. There is no released official phone app yet, so for automatic backup from phones, Immich is the stronger choice.

Cloudgate installs LibrePhotos on a server Cloudgate provides or one you connect, with its database, and gives it a secure web address. You sign in as admin with the password Cloudgate shows you. Face recognition needs a fairly large server, and your storage is the size of its disk.

## What you can do with LibrePhotos

- **See your photos by day and place**: The timeline groups pictures by the day and place they were taken, with memories from the same day in earlier years.
- **Find the people in your photos**: LibrePhotos recognises faces; name a person once and it suggests the rest of their photos.
- **Search in plain words**: Type "dog on a beach", a person's name, a place or a camera, and matching photos appear.
- **Get albums made for you**: Days out become event albums such as "Saturday in Lisbon", and photos get tags and a short written caption.
- **Browse a world map**: Places shows every photo with a location on a map and lists the countries and cities you have been to.
- **Keep RAW files, videos and Live Photos**: RAW camera files, HEIC pictures, videos and Live Photos sit next to ordinary JPEGs, and a RAW and JPEG of one shot stay together.
- **Share with family and friends**: Give each person an account, share albums as viewer or contributor, share a whole library, or send a public link.

## Replaces Google Photos and iCloud Photos

LibrePhotos does the same job as Google Photos and iCloud Photos. Here is what changes when you switch.

### What you gain

- No storage plan to upgrade; you are limited only by your server's disk
- Faces, tags and captions are worked out on your own server, not by an outside company
- A Google Takeout download comes in with its dates, places and descriptions
- Free and open source under the MIT licence, with no paid edition

### What is different

- There is no official phone app yet, so there is no automatic phone backup from LibrePhotos itself
- Face recognition and captions need a server with plenty of memory, and the first scan of a big library takes time
- There is no two-step sign-in and no password on share links

## What happens when you click Deploy?

Deploy link: https://cloudgate.octabyte.app/get-started?template=librephotos

1. **Click Deploy and create your account.** Deploy takes you to Cloudgate. Create an account, or log in if you have one. LibrePhotos itself is free.
2. **Choose a server.** No server? Get one from Cloudgate: pick a size and a country, and Cloudgate gets it ready. Already have one? Connect it instead.
3. **Cloudgate sets up LibrePhotos.** It prepares the server, makes the passwords the app needs and starts it. There is nothing to install and nothing to write down.
4. **Open your app and sign in.** Your app gets a free web address to start, without https. Add your own domain, like app.yourshop.com, and Cloudgate secures it with https for you.

## Questions

### Is LibrePhotos free?

Yes. LibrePhotos is free, open-source software under the MIT licence, with no paid edition or locked features. You pay only for your server and its disk.

### Is LibrePhotos a good alternative to Google Photos?

Yes, LibrePhotos can replace Google Photos for organising and searching a photo library. It recognises faces, shows your photos on a map, makes event albums and memories, and finds photos by plain words. It is weaker at phone backup, because its official phone app is not released yet.

### How is LibrePhotos different from Immich and PhotoPrism?

LibrePhotos is a library you browse, like PhotoPrism, while Immich is built around phone backup with released iPhone and Android apps. Compared with Immich, LibrePhotos adds scene tags, written captions and ready-made event albums; compared with PhotoPrism, it adds memories, shared albums others can add to, and sharing a whole library. LibrePhotos uses the MIT licence; the other two use the AGPL.

### Can I move my photos from Google Photos to LibrePhotos?

Yes. Download your library with Google Takeout, copy the unzipped files into your LibrePhotos photo folder on the server and run a scan; LibrePhotos reads each photo's date, place and description from the Takeout files. Albums, people and favourites are not carried over.

### Is there a LibrePhotos phone app?

No, not a released official one yet. LibrePhotos works in any phone browser, and UhuruPhotos, a separate app made by another developer, connects to it on Android and is in open beta on Google Play.

### What server size do I need for LibrePhotos?

LibrePhotos needs at least 4 GB of memory and 2 CPU cores, and its makers recommend 8 GB and 4 cores, because face recognition and captions use a lot of memory. Plan the disk for your whole library plus room for thumbnails.

### How do I sign in to LibrePhotos the first time?

Sign in with the username admin and the password Cloudgate shows you after setup. LibrePhotos sets the admin password back to that one each time it restarts, so a password you change inside LibrePhotos does not last; keep using the one Cloudgate shows. As admin you choose your photo folder and can add accounts for family members or colleagues.

### Do I need technical skills to run LibrePhotos?

No. Click Deploy, create your Cloudgate account and choose a server, and Cloudgate sets up LibrePhotos and gives it a web address. You use it in your browser like any other online tool.

### Do I need my own server for LibrePhotos?

No. When you deploy LibrePhotos, hosted Cloudgate can provide a server. If you already rent one, you can connect it instead.
