Wissen / Erste Schritte

Installation mit Docker oder Podman

Von den Images bis zum laufenden Container, auch für Server ohne Internetzugang.

Die Anleitung verwendet docker compose. Mit Podman ersetzt du es durch sudo podman-compose, alles andere bleibt gleich.

1. Ordner anlegen

sudo mkdir -p /opt/contracthub/{db,files}
sudo chown 70:70 /opt/contracthub/db && sudo chmod 700 /opt/contracthub/db
sudo chown 1000:1000 /opt/contracthub/files
cd /opt/contracthub

UID 70 ist der Benutzer postgres im Datenbank-Image, UID 1000 der Benutzer der Anwendung.

2. Images holen

Die Adresse der Registry und die Zugangsdaten bekommst du mit dem Testzugang oder der Lizenz.

docker login <registry>
docker pull <registry>/contracthub:<version>
docker pull postgres:16-alpine

Trage immer eine feste Version ein, nicht latest. So ist klar, was läuft, und der Weg zurück ist eine Zeile.

Server ohne Internetzugang

Zu jedem Release gibt es ein Paket contracthub-images-<version>.tar.gz mit beiden Images und einer Prüfsumme. Kopiere beide Dateien auf den Server:

sha256sum -c contracthub-images-<version>.tar.gz.sha256
docker load -i contracthub-images-<version>.tar.gz

Die Images heißen danach localhost/contracthub:<version> und localhost/postgres:16-alpine. Trage diese Namen in der compose.yaml ein.

3. Geheimnisse erzeugen

openssl rand -hex 24      # Datenbankpasswort
openssl rand -base64 48   # SESSION_SECRET
openssl rand -base64 32   # SECRETS_ENCRYPTION_KEY

4. Konfiguration

/opt/contracthub/postgres.env:

POSTGRES_DB=contracthub
POSTGRES_USER=contracthub
POSTGRES_PASSWORD=<Datenbankpasswort>

/opt/contracthub/contracthub.env:

# Adresse, unter der Benutzer Kontris erreichen
APP_BASE_URL=https://contracthub.example.com
TZ=Europe/Berlin
# 1 = genau ein Reverse Proxy davor
TRUST_PROXY=1

DATABASE_URL=postgres://contracthub:<Datenbankpasswort>@contracthub-db:5432/contracthub
SESSION_SECRET=<zweiter Wert>
SECRETS_ENCRYPTION_KEY=<dritter Wert>

# Anmeldung: zuerst nur lokale Konten, Single Sign-on kommt später dazu
LOCAL_AUTH_ENABLED=true
OIDC_ENABLED=false

MAIL_ENABLED=false
FILE_STORAGE_PATH=/data/files

Schreibe Werte ohne Anführungszeichen und Kommentare in eigene Zeilen. Danach die Dateien schützen:

sudo chmod 600 contracthub.env postgres.env

/opt/contracthub/compose.yaml:

name: contracthub

services:
  contracthub-db:
    image: postgres:16-alpine
    container_name: contracthub-db
    restart: always
    env_file: postgres.env
    security_opt: [no-new-privileges:true]
    volumes:
      - ./db:/var/lib/postgresql/data
    networks: [db]
    healthcheck:
      test: ['CMD-SHELL', 'pg_isready -q -U $${POSTGRES_USER} -d $${POSTGRES_DB}']
      interval: 10s
      timeout: 5s
      retries: 5

  contracthub:
    image: <registry>/contracthub:<version>
    container_name: contracthub
    restart: always
    env_file: contracthub.env
    user: '1000:1000'
    security_opt: [no-new-privileges:true]
    cap_drop: [ALL]
    ports:
      # nur lokal erreichbar, der Reverse Proxy leitet hierher weiter
      - '127.0.0.1:3000:3000'
    volumes:
      - ./files:/data/files
    networks: [db, default]
    depends_on:
      - contracthub-db

networks:
  db:
    internal: true

Die Datenbank hängt nur am internen Netz db und ist von außen nicht erreichbar. Auf Systemen mit SELinux (RHEL, Fedora) hängst du an die Volumes :Z an, zum Beispiel ./files:/data/files:Z.

5. Starten

docker compose up -d
docker compose ps
docker compose logs -f contracthub

Beide Container müssen laufen, die Datenbank mit dem Status healthy. Ein einzelner Neustart der Anwendung direkt nach dem ersten Start ist normal, wenn die Datenbank noch nicht bereit war. Das Log zeigt „Kontris … started“ mit einer Übersicht der Einstellungen. Fehlt ein Wert oder ist er ungültig, beendet sich die Anwendung mit einer Meldung, die die Variable nennt.

Mit Podman startest du die Container nach einem Neustart des Servers so:

sudo systemctl enable podman-restart.service

Weiter mit Erste Anmeldung und Lizenz.

Stand 15.11.2026 · Kommst du nicht weiter? Schreib uns