15-Minuten-Einrichtung

Papyro installieren

Diese Anleitung führt durch die Installation von Papyro auf Ihrem eigenen Server. Grundlegende Docker-Kenntnisse werden vorausgesetzt.

1. Voraussetzungen

Docker 24+ und docker compose v2
Mindestens 2 GB RAM, 10 GB Festplatte
Reverse-Proxy mit HTTPS (Cloudflare, Traefik, nginx)
Eine Domain oder Subdomain (z. B. papyro.yourcompany.com)
Ihr erworbener LICENSE_KEY (per E-Mail)
Ihr GHCR-Token (zum Abrufen des Images, per E-Mail)

2. Arbeitsverzeichnis einrichten

mkdir papyro && cd papyro
curl -fsSL https://papyro.dev/install/docker-compose.yml -o docker-compose.yml
curl -fsSL https://papyro.dev/install/env.example -o .env

3. Die .env-Datei ausfüllen

Fügen Sie die Werte aus Ihrer Kauf-E-Mail ein:

# Domain
BETTER_AUTH_URL=https://papyro.yourcompany.com

# Database password (generate randomly)
DB_PASSWORD=$(openssl rand -hex 16)

# Better Auth secret (generate randomly)
BETTER_AUTH_SECRET=$(openssl rand -hex 32)

# Redis password (generate randomly)
REDIS_PASSWORD=$(openssl rand -hex 16)

# Cron secret (generate randomly)
CRON_SECRET=$(openssl rand -hex 32)

# License (from your purchase email)
LICENSE_KEY=eyJ2IjoxLCJjdXN0b21lciI6...

# AG Grid Enterprise license (data-grid block renders watermarked without it)
AG_GRID_LICENSE_KEY=

# OpenAI API key ("ask the grid" feature)
OPENAI_API_KEY=

# R2 backup (optional)
R2_ACCOUNT_ID=
R2_ACCESS_KEY_ID=
R2_SECRET_ACCESS_KEY=
R2_BUCKET=

Führen Sie die openssl rand-Befehle in Ihrem Terminal aus und fügen Sie die Ausgaben ein. Verlieren Sie diese nicht — sie werden für den Zugriff auf die DB benötigt.

4. Das Docker-Image abrufen

Verwenden Sie das GHCR-Token, das wir Ihnen per E-Mail geschickt haben, um sich anzumelden und das Image abzurufen:

echo "ghp_xxxxxxxxxxxx" | docker login ghcr.io \
  -u egebilge --password-stdin

docker pull ghcr.io/egebilge/papyro:v1.0.0

5. Ausführen

docker compose up -d

Der erste Start dauert 30–60 Sekunden (Migrationen laufen, Container fahren hoch).

6. Den ersten Administrator anlegen

Öffnen Sie https://papyro.yourdomain.com in einem Browser. Der Einrichtungsassistent erscheint — geben Sie die Daten Ihres ersten Nutzers ein. Dieser erste Nutzer wird mit der Super-Admin-Rolle angelegt, und der Assistent läuft genau einmal.

7. Lizenzstatus überprüfen

Gehen Sie zu Admin → Lizenz (Seitenleiste). Ihr Kundenname, Ihre Edition, Anzahl der Plätze und Ablaufdatum sollten erscheinen.

Fehlerbehebung

LICENSE_KEY is not set

Cause / Sebep: Umgebungsvariable fehlt oder wurde falsch kopiert.

Fix / Çözüm: Fügen Sie die exakte Zeile aus Ihrer Kauf-E-Mail in .env ein. Neu starten: docker compose up -d --force-recreate app

LICENSE_KEY is invalid: malformed envelope

Cause / Sebep: Der Umschlag wurde unvollständig kopiert (abgeschnittenes Einfügen).

Fix / Çözüm: Markieren und kopieren Sie die gesamte LICENSE_KEY=...-Zeile aus der E-Mail. Sie muss einen Punkt (.) innerhalb des Werts enthalten.

LICENSE_KEY is invalid: invalid signature

Cause / Sebep: Falsche Image-Version oder der Umschlag gehört zu einem anderen Anbieter-Binary.

Fix / Çözüm: Überprüfen Sie das Image-Tag in Ihrem docker pull-Befehl. Für Hilfe kontaktieren Sie [email protected].

LICENSE_OVER_SEAT — Cannot add new user

Cause / Sebep: Ihr Lizenz-Platzlimit ist voll.

Fix / Çözüm: Schreiben Sie an [email protected], um Ihre Stufe zu erhöhen, oder löschen Sie gesperrte/inaktive Nutzer.

Verlängerung

Wir senden Ihnen 30 Tage vor Ablauf eine E-Mail. Nach der Zahlung trifft ein neuer LICENSE_KEY per E-Mail ein. Ersetzen Sie den Wert in .env und starten Sie neu:

docker compose up -d --force-recreate app

Support

E-Mail: [email protected]

Antwort innerhalb von 48 Stunden. Verwenden Sie das Betreff-Präfix "URGENT" für Notfälle.