Skip to content
DiscVaultDiscVault Docs

Install: Persistent data and PostgreSQL

Goal and result

Section titled “Goal and result”

Operate the two persistent stores used by every DiscVault v26 release channel.

Applies to

Section titled “Applies to”

For both :latest and :beta, application records live in PostgreSQL at DISCVAULT_POSTGRES_DATA; media, profiles, plugins, and file assets live at DISCVAULT_DATA_DIR, mounted as /data. Back up both in one stopped-writer window.

DiscVault v26 stable

Section titled “DiscVault v26 stable”
  • DiscVault v26 stable · ghcr.io/helmerznl/discvault:latest
  • PostgreSQL stores application records
  • /data stores media, profiles, plugins, and file assets

DiscVault v26 beta

Section titled “DiscVault v26 beta”
  • DiscVault v26 beta · ghcr.io/helmerznl/discvault:beta
  • PostgreSQL stores application records
  • /data stores media, profiles, plugins, and file assets

Prerequisites

Section titled “Prerequisites”
  • running v26 Compose stack
  • backup destination outside the live data path
  • PostgreSQL 17

Procedure

Section titled “Procedure”
  1. Inspect: DISCVAULT_POSTGRES_DATA · /var/lib/postgresql/data
  2. Inspect: DISCVAULT_DATA_DIR · /data
  3. Verify: postgres · healthy · next-api
  4. Record: PostgreSQL dump and filesystem archive from the same stopped-writer window · restore rehearsal

Commands and settings

Section titled “Commands and settings”

Both channels

Section titled “Both channels”
Terminal window
docker compose --env-file /opt/discvault/.env -p discvault -f /opt/discvault/compose.yaml ps
docker compose --env-file /opt/discvault/.env -p discvault -f /opt/discvault/compose.yaml exec -T postgres sh -c 'pg_isready -U "$POSTGRES_USER" -d "$POSTGRES_DB"'
docker inspect discvault-next-api-1 --format '{{range .Mounts}}{{.Source}} -> {{.Destination}}{{println}}{{end}}'

Expected result

Section titled “Expected result”

PostgreSQL is healthy, all v26 services run, and both persistent host paths are verified.

  • PostgreSQL · healthy
  • persistent /data
  • matching backup set

Safety and rollback

Section titled “Safety and rollback”

Next step

Section titled “Next step”

Install: Reverse proxy and passkeys

Source and status

Section titled “Source and status”