Deploys¶

deploy/compose/ contains a single-host docker-compose setup for self-hosters.

The runtime needs a public base URL so generated IIIF identifiers are stable:

server:
  public_base_url: "${TRIPLET_PUBLIC_BASE_URL}"

The runtime exposes Prometheus metrics at /metrics when metrics.enabled is true.

metrics:
  enabled: true

Presentation storage migrations¶

When using MariaDB for Presentation storage, apply the schema as a migration step with a DDL-capable account:

iiif:
  presentation:
    enabled: true
    prefix: /presentation/v3
    dsn: triplet:triplet@tcp(mariadb:3306)/triplet?parseTime=true
    write_enabled: false

triplet -config config.yaml -migrate-presentation-mariadb

Normal server startup does not run DDL, so the runtime DSN can use a least-privilege account after migration. The schema contains one generic path-keyed resource table with byte-preserving bodies and no foreign keys.

Treat the Presentation root or MariaDB table as durable state unless the publishing application explicitly documents it as a rebuildable projection. Back up and restore it consistently with that application's publication state.