# Roamlight

Roamlight is a self-hosted family photo library that turns a folder of pictures and videos into private albums and maps. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/6767/roamlight

## Description

Roamlight is a self-hosted family photo library that turns a folder of pictures and videos into private albums and maps. It extracts dates, camera details, and locations from JPEG, HEIC, RAW, and video files, never modifies originals, and supports per-album sharing with expiring password-protected links, OpenID Connect sign-in, and iPhone and Android companion apps.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

47/100 (Fair), based on 3 of 4 factors.
- Maintained: 82 (last commit 22 days ago)
- Popular: 0 (0 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Unraid: https://ca.unraid.net/apps/roamlight-1lf8rq800se6hg?q=Roamlight
- GitHub: https://github.com/Racoon80/roamlight

## Common questions

### Will Roamlight modify the original photo files it indexes?

No. Your photo folder is only read, and Roamlight creates web copies elsewhere so the original files are never touched.

### Which image and video file types can Roamlight process?

It supports JPEG, HEIC, PNG, TIFF, several RAW formats such as CR3, CR2, ARW, NEF, RAF, and DNG, plus video files with poster frames.

### How can family members without an account see an album?

You can create share links with a password, an end date, and an optional view limit.

### Does Roamlight support single sign-on?

Yes. You can sign in with passwords or with your own SSO, including Authentik, Keycloak, or Entra, in the browser and apps.

### How do I install the Android app?

Open your Roamlight site in a phone browser, go to Phone & tablet, and tap Download for Android. The app provides its own updates afterward.

### What are the first steps to set up Roamlight?

Deploy the Docker or Proxmox LXC container, open the web interface, create the administrator account, and point the library at your photo folder.

---
Source: Our Local Host (https://ourlocalhost.com/app/6767/roamlight), the self-hosted and open-source app directory.
