Skip to main content

photos

photos — ɳSelf documentation.

Photos Plugin

Photo album management with EXIF extraction, tagging, and MinIO-backed storage. Pro plugin.

Requires: Basic license tier or higher. nself license set nself_pro_...

Install

nself license set nself_pro_xxxxx...
nself plugin install photos

What It Does

Provides photo album management with automatic EXIF metadata extraction, flexible tagging, and webhook events fired on upload. Stores originals in MinIO and generates configurable thumbnail sizes automatically. Albums and photos are queryable via the Hasura GraphQL API.

Dependencies

Requires the minio plugin.

Configuration

Env VarDefaultDescription
PHOTOS_PORT3091Photos service port
PHOTOS_STORAGE_BUCKETnoneMinIO bucket name for photo storage
PHOTOS_THUMB_SIZES200x200,800x800Comma-separated thumbnail dimensions to generate

Ports

PortPurpose
3091Photos REST API

Database Tables

4 tables added to your Postgres database:

  • np_photos_albums: album records
  • np_photos_photos: photo records with storage references
  • np_photos_tags: tag definitions
  • np_photos_exif: extracted EXIF metadata per photo

Nginx Routes

RouteTarget
/photos/Photos API