Installation: Docker run

Geltungsbereich: DiscVault v26 – stabil · DiscVault v26 – BetaDocker≥ DiscVault v26helmerzNL/DiscVault2026-07-14

Ziel und Ergebnis

Führe den seitenspezifischen Ablauf aus für Installation: Docker run. Dieses Verfahren arbeitet mit DATABASE_URL · discvault-postgres · 6080:5000 · /api/next/health.

Gültig für

Diese Seite gilt ausschließlich für Installation: Docker run (Docker). Kanal- und Datengrenzen sind: DiscVault · ghcr.io/helmerznl/discvault:latest; PostgreSQL API MCP; 6080 → API 5000; DiscVault · ghcr.io/helmerznl/discvault:beta; PostgreSQL API MCP; 6080 → API 5000. Seitenspezifische Kontrollpunkte: DATABASE_URL · discvault-postgres · 6080:5000 · /api/next/health.

DiscVault v26 – stabil

• DiscVault · ghcr.io/helmerznl/discvault:latest
• PostgreSQL API MCP
• 6080 → API 5000

DiscVault v26 – Beta

• DiscVault · ghcr.io/helmerznl/discvault:beta
• PostgreSQL API MCP
• 6080 → API 5000

Voraussetzungen

• Docker Engine 24+
• OpenSSL
• 6080:5000

Vorgehen

1. Festhalten: DISCVAULT_IMAGE · :latest :beta
2. Erstellen: --env-file · DATABASE_URL · Dateirechte nur für den Eigentümer (0600)
3. Starten: discvault-postgres → discvault-api → MCP
4. Verifizieren: 6080:5000 · GET /api/next/health

Befehle und Einstellungen

DiscVault v26 – stabil

export DISCVAULT_IMAGE=ghcr.io/helmerznl/discvault:latest

DiscVault v26 – Beta

export DISCVAULT_IMAGE=ghcr.io/helmerznl/discvault:beta

Beide Kanäle

set -euo pipefail
test -n "$DISCVAULT_IMAGE"
case "$DISCVAULT_IMAGE" in
  ghcr.io/helmerznl/discvault:latest|ghcr.io/helmerznl/discvault:beta) ;;
  *) printf '%s\n' "$DISCVAULT_IMAGE" >&2; exit 64 ;;
esac
install -d -m 0700 /opt/discvault
install -d -m 0750 /srv/discvault
install -d -o 70 -g 70 -m 0700 /srv/discvault-postgres
umask 077
ENV_FILE=/opt/discvault/docker-run.env
test ! -e "$ENV_FILE"
ENV_TMP="$(mktemp "$ENV_FILE.tmp.XXXXXX")"
trap 'rm -f "$ENV_TMP"' EXIT
POSTGRES_PASSWORD="$(openssl rand -hex 32)"
JWT_SECRET="$(openssl rand -hex 32)"
printf '%s\n' \
  'POSTGRES_DB=discvault' \
  'POSTGRES_USER=discvault' \
  "POSTGRES_PASSWORD=$POSTGRES_PASSWORD" \
  "DATABASE_URL=postgresql://discvault:$POSTGRES_PASSWORD@discvault-postgres:5432/discvault" \
  "JWT_SECRET=$JWT_SECRET" \
  'TZ=Europe/Amsterdam' \
  'RP_ID=localhost' \
  'RP_NAME=DiscVault' \
  'RP_ORIGINS=http://localhost:6080' \
  'DISCVAULT_DATA_DIR=/data' \
  'DISCVAULT_PLUGIN_INSTALL_DIR=/data/plugins' \
  'DISCVAULT_WORKER_ID=worker-1' \
  'DISCVAULT_WORKER_POLL_INTERVAL=2' \
  'DISCVAULT_API=http://discvault-api:5000' > "$ENV_TMP"
chmod 0600 "$ENV_TMP"
ln "$ENV_TMP" "$ENV_FILE"
rm -f "$ENV_TMP"
trap - EXIT
docker network inspect discvault >/dev/null 2>&1 || docker network create discvault
docker run -d --name discvault-postgres --restart unless-stopped \
  --network discvault --env-file "$ENV_FILE" \
  --health-cmd 'pg_isready -U "$POSTGRES_USER" -d "$POSTGRES_DB"' \
  --health-interval 10s --health-timeout 5s --health-retries 10 \
  -v /srv/discvault-postgres:/var/lib/postgresql/data postgres:17-alpine
until [ "$(docker inspect discvault-postgres --format '{{.State.Health.Status}}')" = healthy ]; do
  sleep 2
done
docker run -d --name discvault-api --restart unless-stopped \
  --network discvault --env-file "$ENV_FILE" -w /opt/discvault/backend \
  -p 6080:5000 -v /srv/discvault:/data "$DISCVAULT_IMAGE" \
  sh -c 'python next_database.py migrate && exec gunicorn --bind 0.0.0.0:5000 --workers 2 --timeout 180 next_app:app'
until curl --fail http://localhost:6080/api/next/health; do sleep 2; done
docker run -d --name discvault-worker --restart unless-stopped \
  --network discvault --env-file "$ENV_FILE" -w /opt/discvault/backend \
  -v /srv/discvault:/data "$DISCVAULT_IMAGE" python next_worker.py work
docker run -d --name discvault-mcp --restart unless-stopped \
  --network discvault --env-file "$ENV_FILE" -w /opt/discvault/mcp-server \
  -p 6090:6090 "$DISCVAULT_IMAGE" \
  python server.py --http --host 0.0.0.0 --port 6090
docker ps --filter 'name=discvault-'

Erwartetes Ergebnis

Akzeptiere das Ergebnis für Installation: Docker run nur wenn alle folgenden Ergebnisse erfüllt sind: HTTP 2xx · /api/next/health; discvault-postgres. Seitenspezifische Kontrollpunkte: DATABASE_URL · discvault-postgres · 6080:5000 · /api/next/health.

• HTTP 2xx · /api/next/health
• discvault-postgres

Sicherheit und Rollback

Achtung

Die sichere Wiederherstellungsgrenze für Installation: Docker run verlangt vor jedem Start oder Fortsetzen diese Maßnahmen: Docker Compose; passender Sicherungssatz · PostgreSQL /data. Seitenspezifische Kontrollpunkte: DATABASE_URL · discvault-postgres · 6080:5000 · /api/next/health.

• Docker Compose
• passender Sicherungssatz · PostgreSQL /data

Nächster Schritt

Installation: Erster Start und Zustandsprüfung

Quelle und Status

• helmerzNL/DiscVault@6d27c689ac21
• Quelle und Status: 2026-07-14
• DiscVault Docs: 0.1.0