Pular para o conteúdo
DiscVaultDiscVault Docs

Instalação: Docker run

Objetivo e resultado

Seção intitulada “Objetivo e resultado”

Conclua o procedimento específico da página para Instalação: Docker run. Este procedimento utiliza DATABASE_URL · discvault-postgres · 6080:5000 · /api/next/health.

Aplicável a

Seção intitulada “Aplicável a”

Esta página aplica-se apenas a Instalação: Docker run (Docker). Os limites de canal e dados são: DiscVault · ghcr.io/helmerznl/discvault:latest; PostgreSQL API MCP; 6080 → API 5000; DiscVault · ghcr.io/helmerznl/discvault:beta; PostgreSQL API MCP; 6080 → API 5000. Pontos de controlo desta página: DATABASE_URL · discvault-postgres · 6080:5000 · /api/next/health.

DiscVault v26 estável

Seção intitulada “DiscVault v26 estável”
  • DiscVault · ghcr.io/helmerznl/discvault:latest
  • PostgreSQL API MCP
  • 6080 → API 5000

DiscVault v26 beta

Seção intitulada “DiscVault v26 beta”
  • DiscVault · ghcr.io/helmerznl/discvault:beta
  • PostgreSQL API MCP
  • 6080 → API 5000

Pré-requisitos

Seção intitulada “Pré-requisitos”
  • Docker Engine 24+
  • OpenSSL
  • 6080:5000

Procedimento

Seção intitulada “Procedimento”
  1. Registar: DISCVAULT_IMAGE · :latest :beta
  2. Criar: --env-file · DATABASE_URL · permissões de ficheiro apenas para o proprietário (0600)
  3. Iniciar: discvault-postgres → discvault-api → MCP
  4. Verificar: 6080:5000 · GET /api/next/health

Comandos e definições

Seção intitulada “Comandos e definições”

DiscVault v26 estável

Seção intitulada “DiscVault v26 estável”
Terminal window
export DISCVAULT_IMAGE=ghcr.io/helmerznl/discvault:latest

DiscVault v26 beta

Seção intitulada “DiscVault v26 beta”
Terminal window
export DISCVAULT_IMAGE=ghcr.io/helmerznl/discvault:beta

Ambos os canais

Seção intitulada “Ambos os canais”
Terminal window
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-'

Resultado esperado

Seção intitulada “Resultado esperado”

Aceite o resultado de Instalação: Docker run apenas quando todos os resultados abaixo forem confirmados: HTTP 2xx · /api/next/health; discvault-postgres. Pontos de controlo desta página: DATABASE_URL · discvault-postgres · 6080:5000 · /api/next/health.

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

Segurança e reversão

Seção intitulada “Segurança e reversão”

Próximo passo

Seção intitulada “Próximo passo”

Instalação: Primeiro arranque e verificação de estado

Fonte e estado

Seção intitulada “Fonte e estado”