Installationguide

Paktrex in 10 Minuten auf deinem Server installieren – Schritt für Schritt.

⚡ Quick Start

Für alle, die direkt loslegen wollen.

Ein Befehl – und los:

# Paktrex installieren (automatisches Script)
curl -fsSL https://get.paktrex.de/install.sh | bash

Das Script prüft Docker, lädt die Dateien, generiert einen Secret-Key und startet Paktrex. Danach http://localhost:8000 im Browser öffnen.

📋 Voraussetzungen

Was du brauchst, bevor es losgeht.

🐳

Docker & Docker Compose

Docker 20.10+ und Docker Compose v2+. Prüfen mit docker --version

🖥️

Server / PC

1 GB RAM, 2 GB Festplatte. Läuft auf Raspberry Pi, Mini-PC, VPS oder deinem lokalen Rechner.

🌐

Netzwerk

Port 8000 erreichbar. Für externen Zugriff: Reverse Proxy mit SSL (Nginx, Caddy, Traefik).

🔧 Schritt-für-Schritt Installation

Manuelle Installation – volle Kontrolle über jeden Schritt.

1

Docker installieren (falls nicht vorhanden)

# Docker installieren
curl -fsSL https://get.docker.com | sh

# User zur Docker-Gruppe hinzufügen (ohne sudo)
sudo usermod -aG docker $USER

# Neu anmelden oder:
newgrp docker

# Prüfen:
docker --version
docker compose version
2

Paktrex installieren und starten

curl -fsSL https://get.paktrex.de/install.sh | bash

✅ Das Script prüft Docker, lädt Paktrex, generiert einen Secret-Key und startet den Container.

Manuelle Installation (für Fortgeschrittene)
# Verzeichnis erstellen
mkdir -p ~/paktrex && cd ~/paktrex

# Paktrex starten
docker run -d \
  --name paktrex \
  -p 8000:8000 \
  -v paktrex_data:/opt/contract-mgmt/data \
  --restart unless-stopped \
  paktrex/paktrex:latest
3

Setup-Wizard im Browser durchlaufen

Browser öffnen: http://localhost:8000

Schritt 1Lizenzkey eingeben → Kostenlosen Key anfordern Schritt 2Admin-Passwort festlegen Schritt 3Paperless-NGX einrichten Fertig ✓Dashboard wird angezeigt

Alles Weitere – Paperless, E-Mail, Benachrichtigungen – konfigurierst du später in den Einstellungen.

🔒 SSL / HTTPS (optional)

Für Zugriff von außerhalb deines Netzwerks oder über eine Domain.

🚀

Caddy (empfohlen)

Automatisches SSL mit Let's Encrypt. Keine Konfiguration nötig.

app.paktrex.de {
  reverse_proxy localhost:8000
}
🔧

Nginx

Klassischer Reverse Proxy. Manuelle SSL-Konfiguration mit Certbot.

certbot certonly --nginx \
  -d app.paktrex.de
🐳

Traefik

Docker-native Lösung. Automatisches SSL direkt im Docker-Stack.

📄 Paperless-NGX Integration

Paperless ist das dokumentenführende System von Paktrex. Du kannst es bei der Installation mit installieren oder eine vorhandene Instanz verknüpfen.

Paperless verknüpfen

Voraussetzung: Paperless-NGX läuft bereits in deinem Netzwerk.

1.In Paperless: Einstellungen → API-Token kopieren 2.In Paktrex: Setup-Wizard oder Einstellungen → Paperless 3.URL und Token eintragen → Verbindung testen ✅Dokumente werden direkt in Paktrex angezeigt

📖 Befehlsreferenz

# Starten
docker compose up -d

# Stoppen
docker compose down

# Neustarten
docker compose restart

# Logs anzeigen
docker compose logs -f

# Update auf neue Version
docker compose pull && docker compose up -d

# Status prüfen
docker compose ps

# Health-Check
curl http://localhost:8000/api/health

📸 Screenshots

So sieht Paktrex aus – Dark Mode, modern, übersichtlich.

📊 Dashboard – Kostenübersicht & Timeline

Dashboard

Kosten nach Kategorie, Timeline, offene Aufgaben – alles auf einen Blick.

✉️ Kündigungs-Assistent – 3 Schritte zum Ziel

Kündigungs-Assistent

Methode wählen, Schreiben generieren, Status verfolgen.

📋 Vertragsübersicht – Alle Verträge zentral

Vertragsübersicht

Kategorien, Filter, Suche – alle Verträge an einem Ort.

🔧 Setup-Wizard – In 4 Schritten eingerichtet

Setup-Wizard

Lizenz → Admin → Paperless → Fertig. In 2 Minuten einsatzbereit.

💡 Echte Screenshots folgen – diese Platzhalter zeigen die Feature-Bereiche.

❓ Häufige Fragen zur Installation

Kann ich Paktrex ohne Docker installieren?

Ja, Paktrex ist eine Python/FastAPI-Anwendung. Du kannst sie direkt mit Python 3.11+ und pip installieren. Docker ist aber der empfohlene Weg.

Läuft Paktrex auf einem Raspberry Pi?

Ja, mit 1 GB RAM läuft Paktrex problemlos. Die Docker-Images sind für ARM-Architektur verfügbar.

Wie sichere ich meine Daten?

Die SQLite-Datenbank liegt im Docker-Volume paktrex_data. Backup: docker cp paktrex:/opt/contract-mgmt/data/ ./backup/

Kann ich Paktrex im Heimnetz ohne SSL betreiben?

Ja! Im lokalen Netzwerk reicht HTTP. SSL wird nur benötigt, wenn Paktrex über das Internet erreichbar sein soll.

Wie aktualisiere ich Paktrex?

docker compose pull && docker compose up -d – das zieht das neueste Image und startet den Container neu. Deine Daten bleiben erhalten.

Bereit loszulegen?

Lizenzkey anfordern Features ansehen