bacchilu/veritas-app repository overview

⁠Veritas Provenance

Web application to search ERR and Getty Sales Catalogs records by artist surname.

Built with Flask and PostgreSQL, with email/password authentication and invite-based registration.

⁠Requirements

A PostgreSQL database with the project schema and archival data already loaded. Database setup and data imports are managed separately from this image.

⁠Run locally

Create a .env file with your configuration:

DATABASE_URL=postgresql://USER:PASSWORD@HOST:5432/DBNAME?sslmode=require
SECRET_KEY=replace-with-a-long-random-secret
APP_PASSWORD=replace-with-a-registration-invite-code
SESSION_COOKIE_SECURE=false

SECRET_KEY signs authentication sessions. APP_PASSWORD is the invite code required to register an account.

Download and start the image:

docker pull bacchilu/veritas-app:v1

docker run --rm \
  --env-file .env \
  -e PORT=8080 \
  -e FLASK_DEBUG=0 \
  -p 5000:8080 \
  bacchilu/veritas-app:v1

Open http://localhost:5000⁠, select Sign up, and register using your invite code.

⁠Deployment

The container runs Gunicorn as a non-root user and listens on the port specified by PORT, which defaults to 8080.

For HTTPS deployments, set SESSION_COOKIE_SECURE=true. Supply credentials at runtime through environment variables or a secret manager.

⁠Links

• Source code⁠
• Live application⁠