viktorstrate/photoview repository overview

Photoview is a simple and user-friendly photo gallery that can easily be installed on personal servers. It's made for photographers and aims to provide an easy and fast way to navigate directories, with thousands of high resolution photos.

⁠Demo site

Visit https://photos.qpqp.dk/⁠

Username: demo Password: demo

⁠Main features

• Closely tied to the file system. The website presents the images found on the local filesystem of the server, directories are mapped to albums.
• User management. Each user is created along with a path on the local filesystem, photos within that path can be accessed by that user.
• Photo sharing. Photos and albums can easily be shared with other users or publicly with a unique URL.
• Made for photography. The website is ment as a way to present photographies, and thus supports RAW file formats, and EXIF parsing.
• Performant. Thumbnails are automatically generated and photos first load when they are visible on the screen. In full screen, thumbnails are displayed until the high resolution image has been fully loaded.

⁠Docker Setup

1. Make a new docker-compose.yml file on your computer, and copy the content of docker-compose.example.yml⁠ to the new file.
2. Edit docker-compose.yml, find the comments starting with Change This:, and change the values, to properly match your setup. If you are just testing locally, you don't have to change anything.
3. Start the server by running the following command

$ docker-compose up -d

If the endpoint or the port hasn't been changed in the docker-compose.yml file, Photoview can now be accessed at http://localhost:8000⁠

⁠Initial Setup

If everything is setup correctly, you should be presented with an initial setup wizard, when accessing the website the first time.

Enter a new username and password.

For the photo path, enter the path in the docker container where your photos are located. This can be set from the docker-compose.yml file under api -> volumes. The default location is /photos

A new admin user will be created, with access to the photos located at the path provided under the initial setup.

The photos will have to be scanned before they show up, you can start a scan manually, by navigating to Settings and clicking on Scan All