Skip to content

Configuration

Codex edited this page Jun 13, 2026 · 1 revision

Configuration

Most installs only need to edit secrets in .env.

Variable Default Notes
VAULT_JWT_SECRET changeme... Change before exposing the UI
VAULT_DB_URL sqlite:////data/db/printstash.sqlite SQLite by default; Postgres optional
VAULT_STORAGE_BACKEND local local or s3
VAULT_DATA_DIR /data/files Container path for stored files
VAULT_THUMB_DIR /data/thumbs Container path for generated thumbnails
VAULT_MAX_UPLOAD_MB 512 Upload size limit
VAULT_BACKUP_DIR /data/backups Container path for backup archives
VAULT_LOG_LEVEL INFO Backend log level

The VAULT_ prefix is retained for compatibility from early development. See .env.example for the full list, including S3/R2, backups, MinIO, Postgres, and lifecycle settings.

Storage

SQLite plus local disk is the default deployment path. Postgres and S3/R2 are optional for larger installs or storage-specific homelab setups.

For existing installs, read UPGRADE.md before changing database or storage settings.

Clone this wiki locally