Skip to content

Quick Start

Simple Executable

  1. [Download and unpack a release] to a folder with folders of photos.
  2. Run ./photofield or double-click on photofield.exe to start the server.
  3. Open http://localhost:8080 and you should see folders in the directory displayed as collections.
  4. You're done 🥳

Check out Dependencies that can enhance your experience and Usage for more details.

Docker

Make sure you create an empty data directory in the working directory and that you put some photos in a photos directory.

sh
docker run -p 8080:8080 -v "$PWD/data:/app/data" -v "$PWD/photos:/app/photos:ro" ghcr.io/smilyorg/photofield

The cache database will be persisted to the data dir and the app should be accessible at http://localhost:8080. It should show the photos collection by default. For further configuration, create a configuration.yaml in the data dir.

Docker Compose

This example binds the usual Synology Moments photo directories and assumes a certain path structure, modify to your needs graciously. It also assumes you have configured the /photo and /user directories as collections in configuration.yaml.

yaml
version: '3.3'
services:

  photofield:
    image: ghcr.io/smilyorg/photofield:latest
    ports:
      - 8080:8080
    volumes:
      - /volume1/docker/photofield/data:/app/data
      - /volume1/photo/:/photo:ro
      - /volume1/homes/ExampleUser/Drive/Moments:/exampleuser:ro