# Photoview

> A self-hosted photo gallery that turns your folders into albums.

- Page: https://cgt.octabyte.io/templates/photoview/
- Category: Files & photos
- Replaces: Google Photos and SmugMug
- Ease of use: Some setup. Create the admin account in Photoview, upload photos at the second web address, then press Scan All in Settings.
- App price: Free. To run it you need Cloudgate (hosted, or free to install yourself) and a server, which hosted Cloudgate can provide.
- License: AGPL-3.0-only
- Good for: Photographers and families who keep photos as files and want a fast, private gallery to browse and share them
- Official website: https://photoview.github.io
- Documentation: https://photoview.github.io/docs/
- Source code: https://github.com/photoview/photoview
- Last updated: 2026-11-20

## What is Photoview?

Photoview is a self-hosted photo gallery that turns your folders into albums, shows RAW photos and videos, groups faces and shares albums by link.

Photoview is a free, open-source, self-hosted photo gallery that shows the photos and videos in your folders as albums and a date timeline and lets you share them by link, a private alternative to Google Photos or SmugMug galleries. It reads your files without changing them, so your originals stay exactly as they are.

Photoview makes thumbnails as soon as it scans a folder, so browsing thousands of large photos stays quick. It shows RAW camera files and videos in the browser, lists the camera, lens and exposure beside each picture, and groups photos by the faces in them. A photographer, for example, could upload each shoot as a folder, check the RAW files from anywhere, and send a client a password-protected link to their album.

You can add users who each see only their own folders, which suits a family archive or a small studio. Photoview works in any web browser, on a computer or a phone, but it has no phone backup or phone app.

Cloudgate installs Photoview on a server Cloudgate provides or one you connect, with its database and a simple upload app at a second web address, and gives both secure web addresses. The first person to open Photoview creates the admin account; you then upload photos and start a scan in Settings.

## What you can do with Photoview

- **See every photo on a timeline**: Browse your whole library by date, or open one album at a time, with thumbnails that load quickly.
- **Keep your folders as albums**: Each folder you upload becomes an album, and Photoview never changes or moves your original files.
- **View RAW photos and videos**: RAW camera files and common video formats play in the browser, with the camera, lens and exposure shown beside each photo.
- **Find photos of a person**: Photoview groups faces it finds, so you can name a person and see every photo they are in.
- **Share an album by link**: Send a link to one album or photo, with an optional password, so the viewer needs no account.
- **Give each person their own photos**: Add users with their own folders, so family members or clients see only their own pictures.

## Replaces Google Photos and SmugMug

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

### What you gain

- No storage plan or subscription; you are limited only by your server's disk
- Your photos stay as plain files in folders, so you can leave at any time
- Original files and RAW photos are kept exactly as they are

### What is different

- Photoview has no phone backup or phone app; you add photos by uploading them in the browser
- New photos show up after a scan, which you start in Settings or set to run on a schedule
- There is no search by words, no print sales and no customer proofing

## What happens when you click Deploy?

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

1. **Click Deploy and create your account.** Deploy takes you to Cloudgate. Create an account, or log in if you have one. Photoview 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 Photoview.** 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 Photoview free?

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

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

Partly. Photoview is a good private gallery for photos you already have, with a timeline, albums, faces and share links. Unlike Google Photos, it does not back up your phone and has no phone app or search by words; Immich is the closer match for that.

### How do I add photos to Photoview?

You upload photos in your browser at a second web address that Cloudgate sets up next to Photoview, signing in as admin with the password Cloudgate shows. Photoview itself only displays photos, so after uploading press Scan All in its Settings, or turn on the scheduled scan.

### Who is the Photoview admin?

The first person to open Photoview's web address chooses the admin name and password in its setup screen, so do this right after setup and keep the photo folder it suggests. The admin can then add other users.

### Can I share a Photoview album privately?

Yes. In Photoview you can share an album or a single photo or video with a link, and protect the link with a password. The person you send it to does not need an account.

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

Yes, by hand. Photoview has no importer, so download your originals from Google Photos, for example with Google Takeout, and upload the folders; each folder becomes an album.

### Does Photoview have a phone app?

No. Photoview's old iPhone app is no longer maintained or in the App Store, but the gallery works in the web browser on any phone.

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

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

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

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