PhotoView (Photo gallery for self-hosted personal servers)

linux.md

PhotoView Notes

Debian Linux

Date: 2025-06-19

Build

0. Requirements

   $ sudo apt install libdlib-dev  # for go-face
   $ sudo apt install libmagickwand-dev  # for gographics
   $ sudo apt install libmagic-dev  # for gomagic
   $ sudo apt install libatlas-base-dev liblapack-dev  # for linking
   

1. Web UI

   $ cd ui
   $ npm install
   $ npm run build
   

2. API Backend

   $ cd api
   $ go build -v -o photoview .
   

Installation

1. Install files:

   $ mkdir ~/local/photoview
   $ cp -a ui/dist ~/local/photoview/ui
   $ cp -a api/{photoview,data} ~/local/photoview/
   $ cp -a api/example.env ~/local/photoview/.env
   

2. Optional tools:

   $ sudo apt install darktable  # for RAW photos
   $ sudo apt install ffmpeg  # for video transcoding
   $ sudo apt install exiftool  # for EXIF parsing
   

Configuration

1. Edit config file:

   $ cd ~/local/photoview
   $ vim .env
   | PHOTOVIEW_SERVE_UI=1
   | PHOTOVIEW_API_ENDPOINT=http://localhost:4001/
   | PHOTOVIEW_UI_ENDPOINT=http://localhost:4001/
   

2. Start program:

   $ ./photoview
   

3. Open the web UI: http://127.0.0.1:4001/

   Create the user and use it.

References

• https://photoview.github.io/en/docs/installation-manual/