Skip to content
DiscVaultDiscVault Docs

Troubleshooting

Goal and result

Section titled “Goal and result”

Diagnose container startup, reverse proxy/passkeys, PWA cache, native permissions, migration, and data recovery in a safe order.

Applies to

Section titled “Applies to”

Identify the image tag first, then use the shared v26 service graph. A 502 suggests host port 6080 or internal port 5000 health; passkey errors suggest HTTPS, RP_ID, or RP_ORIGINS mismatch.

DiscVault v26 stable

Section titled “DiscVault v26 stable”
  • DiscVault v26 stable · ghcr.io/helmerznl/discvault:latest
  • same service names, port, endpoint, and data stores

DiscVault v26 beta

Section titled “DiscVault v26 beta”
  • DiscVault v26 beta · ghcr.io/helmerznl/discvault:beta
  • same service names, port, endpoint, and data stores

Prerequisites

Section titled “Prerequisites”
  • selected release channel
  • timestamped logs with private data redacted
  • current image digest

Procedure

Section titled “Procedure”
  1. Record: channel + image digest + timestamp
  2. Isolate: container → reverse proxy → browser/app → provider → data
  3. Inspect: timestamped logs with private data redacted · first failing layer
  4. Preserve: PostgreSQL + /data + app storage · before recovery

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
curl --fail http://localhost:6080/api/next/health
docker compose --env-file /opt/discvault/.env -p discvault -f /opt/discvault/compose.yaml logs --tail=200 next-api next-worker next-mcp postgres

Expected result

Section titled “Expected result”

The failing layer is isolated to container, proxy, browser/app, provider, or data and the matching health check is recorded.

  • one failing layer is isolated with its timestamp, status, image digest, and redacted error

Safety and rollback

Section titled “Safety and rollback”

Next step

Section titled “Next step”

Reference

Source and status

Section titled “Source and status”