reference

Environment & Configuration

All environment variables required to run a Postbase instance.

Published: March 22, 2026Updated: March 22, 2026

Environment & Configuration

Postbase is configured entirely via environment variables. Copy .env.example to .env.local and populate the values below.

Required Variables

  • DATABASE_URL — Global PostgreSQL connection string (e.g. postgresql://user:pass@localhost:5432/postbase)

  • NEXTAUTH_SECRET — Secret used by NextAuth.js and as fallback JWT signing key

  • NEXTAUTH_URL — Canonical URL of your Postbase instance (e.g. https://postbase.yourdomain.com)

Optional / Override Variables

  • POSTBASE_JWT_SECRET — Preferred JWT signing secret. Overrides NEXTAUTH_SECRET when set.

  • MINIO_ENDPOINT — MinIO endpoint (default: http://localhost:9000)

  • MINIO_ACCESS_KEY — MinIO access key (default: minioadmin)

  • MINIO_SECRET_KEY — MinIO secret key (default: minioadmin)

Per-Project Database

Projects can optionally store their own database_url in the projects table. If set, that project's API calls use the project-specific database instead of the global DATABASE_URL.