plugin photos - nself-org/cli GitHub Wiki
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 Var | Default | Description |
|---|---|---|
PHOTOS_PORT |
3091 |
Photos service port |
PHOTOS_STORAGE_BUCKET |
— | MinIO bucket name for photo storage |
PHOTOS_THUMB_SIZES |
200x200,800x800 |
Comma-separated thumbnail dimensions to generate |
Ports
| Port | Purpose |
|---|---|
| 3091 | Photos REST API |
Database Tables
4 tables added to your Postgres database:
np_photos_albums, album recordsnp_photos_photos, photo records with storage referencesnp_photos_tags, tag definitionsnp_photos_exif, extracted EXIF metadata per photo
Nginx Routes
| Route | Target |
|---|---|
/photos/ |
Photos API |