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