unser-geheimnis.de
Open Source · MIT-Lizenz

unser-geheimnis auf deinem eigenen Server

Volle Kontrolle über Daten, Domain und Infrastruktur: Mit einem Install-Script läuft deine eigene Instanz in wenigen Minuten, mit derselben Zero-Knowledge-Verschlüsselung wie hier.

Schnellstart

Auf einem frischen Debian- oder Ubuntu-Server mit einer Domain, die per DNS auf den Server zeigt:

Installation
curl -fsSL https://unser-geheimnis.de/install.sh -o install.sh
less install.sh          # Script vor dem Ausführen lesen
sudo bash install.sh --domain secrets.example.de --proxy caddy

Nach drei bis fünf Minuten läuft deine Instanz unter https://secrets.example.de, mit automatischem HTTPS-Zertifikat von Let's Encrypt. Ohne Optionen fragt das Script alle Angaben interaktiv ab.

Script vorher lesen

Führe niemals ein Script als root aus, das du nicht kennst. Das Installscript ist bewusst kurz, kommentiert und ohne Abhängigkeiten geschrieben. Du findest es auch im Repository unter public/install.sh.

Voraussetzungen

MinimumEmpfohlen
BetriebssystemDebian 12, Ubuntu 22.04Debian 12 / Ubuntu 24.04 LTS
CPU / RAM1 vCPU, 1 GB RAM + 2 GB Swap2 vCPU, 2 GB RAM
Speicher2 GB frei10 GB (Dateien bis 16 MB je Geheimnis)
NetzwerkDomain mit A/AAAA-Record, Ports 80 + 443eigene Subdomain, z. B. secrets.firma.de
Zugangroot bzw. sudo

Node.js 22 installiert das Script bei Bedarf selbst. Als Datenbank dient SQLite, ein separater Datenbankserver ist nicht nötig.

Was das Script macht

  1. Prüft System, Arbeitsspeicher und Rechte.
  2. Installiert git, curl, openssl und Node.js 22 (NodeSource), falls nötig.
  3. Legt den Systembenutzer geheimnis ohne Login-Shell an.
  4. Klont das Repository nach /opt/unser-geheimnis.
  5. Fragt die Angaben fürs Impressum ab und erzeugt .env mit zufälligem APP_SECRET (nur für den Dienst lesbar, Rechte 600).
  6. Installiert Abhängigkeiten, legt die SQLite-Datenbank an und baut die App.
  7. Richtet einen gehärteten systemd-Dienst ein, der nur auf 127.0.0.1 lauscht.
  8. Optional: installiert Caddy als Reverse-Proxy mit automatischem HTTPS.
  9. Prüft, ob die App antwortet, und zeigt eine Zusammenfassung.

Bereits vorhandene .env-Dateien und Daten werden nie überschrieben.

Script-Optionen

OptionBedeutungStandard
--domainÖffentliche Domain der Instanzfragt nach
--proxy caddy|noneCaddy mit HTTPS einrichten oder eigenen Proxy nutzenfragt nach
--dirInstallationsverzeichnis/opt/unser-geheimnis
--portInterner Port (nur localhost)3000
--branchGit-Branchmain
--smtp-hostSMTP-Server für E-Mail-Versand–
--smtp-user / --smtp-passSMTP-Zugangsdaten–
--mail-fromAbsender der E-MailsDomain + SMTP-Benutzer
--legal-name / --legal-emailImpressum: Betreiber und Kontakt-E-Mailfragt nach
--legal-addressImpressum: Anschrift, Zeilen mit | getrenntfragt nach
--legal-phoneImpressum: Telefonoptional
-yOhne Rückfragen (z. B. für Ansible / cloud-init)–

Jede Option gibt es auch als Umgebungsvariable mit Präfix UG_, zum Beispiel für eine automatisierte Installation:

Unbeaufsichtigt
sudo UG_DOMAIN=secrets.example.de UG_PROXY=caddy bash install.sh -y

Reverse-Proxy & HTTPS

HTTPS ist Pflicht: Browser stellen die Web Crypto API zum Verschlüsseln nur auf sicheren Seiten (HTTPS) bereit. Mit --proxy caddy passiert alles automatisch. Läuft auf dem Server schon nginx oder Apache, nutze --proxy none und eine der folgenden Konfigurationen.

Wichtig: X-Forwarded-For setzen, nicht anhängen

Die Rate-Limits (Missbrauchsschutz) nutzen die Client-IP aus X-Forwarded-For. Der Proxy muss den Header mit der echten IP überschreiben. Wird er nur ergänzt, könnte ein Angreifer eine falsche IP mitschicken und die Limits umgehen. Caddy macht das standardmäßig richtig.
nginx — /etc/nginx/sites-available/unser-geheimnis
server {
    listen 443 ssl http2;
    server_name secrets.example.de;
    # ssl_certificate … (z. B. via certbot --nginx)

    client_max_body_size 30m;

    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $remote_addr;   # überschreiben!
        proxy_set_header X-Forwarded-Proto https;
        access_log off;                                   # keine IP-Logs
    }
}
Apache — VirtualHost (mod_proxy, mod_headers)
<VirtualHost *:443>
    ServerName secrets.example.de
    # SSLEngine on … (z. B. via certbot --apache)

    ProxyPreserveHost On
    ProxyRequests Off
    # Vom Client gesendetes X-Forwarded-For verwerfen — mod_proxy setzt die echte IP
    RequestHeader unset X-Forwarded-For
    RequestHeader set X-Forwarded-Proto "https"
    LimitRequestBody 31457280

    ProxyPass        / http://127.0.0.1:3000/
    ProxyPassReverse / http://127.0.0.1:3000/
</VirtualHost>

E-Mail (Daten anfordern)

Teilen und Anfordern per Link funktionieren ohne E-Mail. Für den Versand von Anfragen per E-Mail (mit Bestätigungscode für den Absender) brauchst du einen SMTP-Zugang. Ohne SMTP lehnt der Server den E-Mail-Versand mit einem Hinweis ab; alles andere funktioniert normal.

/opt/unser-geheimnis/.env
SMTP_HOST=smtp.example.de
SMTP_PORT=587                 # 587 = STARTTLS (erzwungen), 465 = TLS
SMTP_USER=noreply@example.de
SMTP_PASS="dein-passwort"
MAIL_FROM="Secrets <noreply@example.de>"
MAIL_DAILY_LIMIT=300          # globale Obergrenze Einladungen/Tag
Übernehmen
sudo systemctl restart unser-geheimnis

Zustellbarkeit

Richte für die Absender-Domain SPF, DKIM und DMARC ein. Microsoft 365 und Gmail verzögern oder filtern Mails von neuen, nicht authentifizierten Absendern. Bei vielen Empfängern bei Microsoft lohnt sich ein spezialisierter Versanddienst (z. B. Brevo oder Mailjet aus der EU).

Konfiguration (.env)

Alle Einstellungen liegen in /opt/unser-geheimnis/.env. Nach Änderungen: sudo systemctl restart unser-geheimnis.

VariableBeschreibung
NEXT_PUBLIC_SITE_URLÖffentliche Adresse inkl. https://. Wird beim Build eingebaut; nach Änderung install.sh update ausführen.
APP_SECRETZufälliger Schlüssel (mind. 32 Zeichen) für Codes, Proof-of-Work und E-Mail-Hashes. Nicht ändern, solange Anfragen offen sind.
DATABASE_URLPfad zur SQLite-Datenbank
UPLOAD_DIRAblage für verschlüsselte Dateien
MAX_FILE_SIZE_MBMaximale Dateigröße (Standard 16)
RATE_LIMIT_MAXGeheimnisse pro IP und Stunde (Standard 10)
SMTP_* / MAIL_FROME-Mail-Versand, siehe oben
LEGAL_*Angaben fürs Impressum, siehe unten

Updates & Backups

Auf die neueste Version aktualisieren
sudo bash install.sh update

Das Update sichert vorher die Datenbank (die letzten fünf Sicherungen bleiben in data/), übernimmt eigene Anpassungen am Code (z. B. Impressum), baut neu und startet den Dienst. Kollidieren Anpassungen mit dem Update, bricht es ab und legt einen Patch in data/ ab.

Backup (z. B. täglich per Cron)
tar -czf /root/ug-backup-$(date +%F).tar.gz -C /opt/unser-geheimnis .env data

Backups enthalten nur verschlüsselte Daten. Ohne die Links der Nutzer sind sie nicht lesbar. Da Geheimnisse nach maximal 48 Stunden ablaufen, ist vor allem die .env wichtig.

Impressum, Datenschutz & Branding

Die Angaben im Impressum stehen nicht im Code, sondern in der .env. Das Installscript fragt sie ab, ändern kannst du sie jederzeit. Danach genügt ein Neustart:

/opt/unser-geheimnis/.env
LEGAL_NAME='Muster GmbH'
LEGAL_ADDRESS='Musterstraße 1|12345 Musterstadt|Deutschland'   # Zeilen mit | trennen
LEGAL_EMAIL='impressum@example.de'
LEGAL_PHONE='+49 123 456789'                 # optional
LEGAL_REPRESENTATIVE='Max Mustermann'        # optional, z. B. Geschäftsführer
LEGAL_REGISTER='Amtsgericht München, HRB 12345'   # optional
LEGAL_VAT_ID='DE123456789'                   # optional
Übernehmen
sudo systemctl restart unser-geheimnis

Datenschutzerklärung prüfen

Die Datenschutzerklärung beschreibt den Betrieb von unser-geheimnis.de, z. B. Hosting in Deutschland und den E-Mail-Dienstleister. Prüfe sie für deine Instanz und passe sie bei Bedarf an. Verantwortlicher ist automatisch der Betreiber aus dem Impressum.
DateiInhalt
src/app/datenschutz/page.tsxDatenschutzerklärung
src/app/layout.tsxSeitentitel, Beschreibung, Open-Graph-Daten
src/components/ui/Icons.tsxLogo / Wortmarke
src/app/globals.cssFarben (Design-Tokens)

Nach Änderungen an diesen Dateien sudo bash install.sh update ausführen. Deine Änderungen bleiben auch bei künftigen Updates erhalten.

Manuelle Installation

Ohne Script, z. B. für andere Distributionen oder Container. Du brauchst Node.js ≥ 20 und git:

Schritt für Schritt
git clone https://github.com/LeonMTN05/unser-geheimnis.git /opt/unser-geheimnis
cd /opt/unser-geheimnis
cat > .env <<EOF
DATABASE_URL="file:/opt/unser-geheimnis/data/prod.db"
NEXT_PUBLIC_SITE_URL="https://secrets.example.de"
UPLOAD_DIR="/opt/unser-geheimnis/data/secrets"
APP_SECRET=$(openssl rand -hex 32)
LEGAL_NAME='Muster GmbH'
LEGAL_ADDRESS='Musterstraße 1|12345 Musterstadt|Deutschland'
LEGAL_EMAIL='impressum@example.de'
EOF
chmod 600 .env && mkdir -p data/secrets

npm ci
set -a && . ./.env && set +a
npx prisma generate && npx prisma db push
NODE_ENV=production npx next build

# Start (dauerhaft per systemd, siehe install.sh → write_service)
NODE_ENV=production npx next start -H 127.0.0.1 -p 3000

Sicherheitshinweise

  • Firewall: nur 22, 80 und 443 öffnen. Der App-Port bleibt auf localhost.
  • Keine Zugriffs-Logs mit IP-Adressen im Reverse-Proxy (DSGVO). Die Pfade enthalten zwar nie Schlüssel (die stehen nur im #-Fragment), trotzdem gilt: so wenig wie möglich protokollieren.
  • Updates regelmäßig einspielen, auch für das Betriebssystem (unattended-upgrades).
  • APP_SECRET geheim halten. Wer es kennt, kann Proof-of-Work-Aufgaben fälschen und die Pseudonymisierung von IPs und E-Mail-Adressen aufheben. Verschlüsselte Inhalte bleiben trotzdem unlesbar.
  • Der Server sieht nie Klartext oder Schlüssel. Ein kompromittierter Server könnte allerdings manipulierten JavaScript-Code ausliefern. Schütze ihn deshalb wie jede andere sicherheitskritische Anwendung.

Deinstallation

Alles entfernen
sudo systemctl disable --now unser-geheimnis
sudo rm /etc/systemd/system/unser-geheimnis.service && sudo systemctl daemon-reload
sudo rm -rf /opt/unser-geheimnis          # löscht auch alle Daten!
sudo userdel geheimnis
# Optional: Block für die Domain aus /etc/caddy/Caddyfile entfernen

Lieber nichts selbst betreiben?

Nutze einfach die gehostete Version: kostenlos, ohne Account, in Deutschland gehostet.

Zu unser-geheimnis.de