// Termax Self-Host · Anleitung
Den Termax Sync Server in 10 Minuten aufsetzen.
Schritt für Schritt: Docker, Domain mit HTTPS, Lizenz, erste Konten. Danach läuft der Server von selbst weiter, holt sich seine Zertifikate und verlängert seine Lizenz.
Linux-Server, NAS oder Raspberry Pi 4/5 · 64 Bit · Docker mit Compose
// Vorher
Was du brauchst
Einen Rechner mit Docker und Docker Compose, 64 Bit (x86 oder ARM), mit etwa 256 MB freiem Arbeitsspeicher. Docker installierst du auf Debian/Ubuntu mit curl -fsSL https://get.docker.com | sh.
Eine Domain oder Subdomain, z. B. sync.firma.de, deren DNS-Eintrag (A bzw. AAAA) auf diesen Rechner zeigt, und offene Ports 80 und 443. Die Apps verbinden sich nur über HTTPS; das Zertifikat holt Caddy automatisch.
Eine Lizenz. In Termax unter Konto → Eigener Server: Self-Host Personal (bis 3 Konten) kostenlos holen oder Self-Host Team kaufen. Sie steht dort jederzeit zum Kopieren bereit („Lizenz kopieren“); eine gekaufte kommt zusätzlich per E-Mail.
// Schritt 1
Dateien holen
In einem leeren Ordner auf dem Server:
mkdir termax-sync && cd termax-sync curl -fsSLO https://termax.app/self-host/dateien/docker-compose.yml curl -fsSLO https://termax.app/self-host/dateien/Caddyfile curl -fsSL -o .env https://termax.app/self-host/dateien/env.example
Das sind die Compose-Datei (Termax Sync Server und Caddy davor), die Caddy-Konfiguration und die Einstellungen.
// Schritt 2
Einstellungen eintragen
Öffne .env mit einem Editor (z. B. nano .env) und trage mindestens diese vier Zeilen ein:
TERMAX_DOMAIN=sync.example.com TERMAX_PUBLIC_URL=https://sync.example.com TERMAX_LICENSE=TMXL1.eyJ2Ijox... (die ganze Zeile aus der App) TERMAX_SIGNUP_ALLOW=@example.com
TERMAX_SIGNUP_ALLOW legt fest, wer auf deinem Server ein Konto anlegen darf: einzelne Adressen (anna@firma.de,ben@firma.de) und/oder ganze Domains (@firma.de). Leer heißt: niemand. Mehr Konten, als die Lizenz erlaubt, nimmt der Server nie an.
Ohne Mailversand bestätigt der Server neue Konten selbst, und „Passwort vergessen“ ist aus. Mit den SMTP-Zeilen in .env verschickt er Bestätigungscodes, Passwort-Resets und Team-Einladungen.
// Schritt 3
Starten und prüfen
docker compose up -d docker compose logs -f termax-sync
In den Logs steht Lizenz erkannt und danach PocketBase mit „Server started“. Dann im Browser https://deine-domain/api/termax/server-info öffnen: dort muss "licensed":true stehen.
Ohne gültige Lizenz startet der Server gar nicht erst, sondern wartet und sagt in den Logs, warum. Eine neue Lizenz in .env übernimmt er nach docker compose up -d.
// Schritt 4
Apps verbinden
In Termax ab 0.9.3 (Windows, Linux, macOS, Android und iPhone): Anmelden → oben „Server ändern“ → https://deine-domain → Verbinden. Die App prüft die Lizenz und zeigt sie an. Dann Registrieren mit einer Adresse aus der Freigabeliste.
Bist du schon mit einem Termax-Konto angemeldet, melde dich zuerst ab; deine Verbindungen bleiben auf dem Gerät und werden beim ersten Abgleich auf deinen Server hochgeladen.
Den Wiederherstellungs-Schlüssel, den die App bei der Registrierung zeigt, unbedingt aufbewahren: Ohne Mailversand gibt es kein „Passwort vergessen“, und auch der Betreiber kann einen Tresor nicht entschlüsseln.
// Betrieb
Updates, Sicherungen, Verwaltung
Updates: docker compose pull && docker compose up -d. Vor dem ersten Start einer neuen Version sichert der Server seine Datenbank selbst nach backups/ im Datenordner (die letzten fünf).
Sicherungen, am einfachsten: in der Verwaltungsoberfläche (siehe unten) unter Settings → Backups. Dort sichert PocketBase im laufenden Betrieb vollständig, auch zeitgesteuert (z. B. täglich) und auf Wunsch auf einen S3-Speicher, und spielt eine Sicherung mit Restore auch wieder ein. Lade die Sicherungen von dort herunter oder lass sie nach S3 schreiben: eine Sicherung, die nur auf demselben Rechner liegt, hilft bei einem Plattenschaden nicht.
Sicherung als Datei von der Kommandozeile (Server dafür kurz aus, nur so ist sie vollständig):
docker compose stop termax-sync docker compose run --rm --no-deps -T --entrypoint sh termax-sync -c 'cd /pb_data && tar czf - .' > termax-backup-$(date +%F).tgz docker compose start termax-sync
Die Tresore darin sind Ende-zu-Ende-verschlüsselt; die Sicherung enthält aber Konten und E-Mail-Adressen, also sicher aufbewahren.
// Verwaltung
Konten, Plätze, Umzug
Verwaltungsoberfläche (optional): Ein Admin-Konto für PocketBase legst du so an; die Oberfläche liegt dann unter https://deine-domain/_/. Dort siehst du alle Konten (Sammlung users) und kannst sie löschen. Inhalte sehen auch Admins nur verschlüsselt. Leg das Admin-Konto gleich nach dem ersten Start an: bis dahin steht im Log ein Link, mit dem jeder, der die Logs sieht, Admin werden kann. Die Oberfläche ist über deine Domain aus dem Internet erreichbar; nimm ein langes, eigenes Passwort, oder lass sie nur aus dem eigenen Netz zu (fertiger Block, auskommentiert, im Caddyfile).
docker compose exec termax-sync pocketbase superuser upsert admin@firma.de 'ein-langes-passwort' --dir /pb_data
Jemanden hinzufügen: Adresse (oder die ganze Domain) in TERMAX_SIGNUP_ALLOW eintragen, docker compose up -d, dann registriert sich die Person selbst in der App. Für geteilte Ordner lädt ein Team-Admin sie danach in der App unter Team ein.
Jemanden entfernen: In der App unter Team aus allen Teams nehmen (die App verschlüsselt die Team-Ordner danach neu), dann in der Verwaltungsoberfläche das Konto löschen und die Adresse aus TERMAX_SIGNUP_ALLOW streichen. Der Platz ist sofort wieder frei.
Passwort vergessen: Mit SMTP setzt die Person es in der App selbst zurück. Ohne SMTP gibt es keinen Reset über den Server. Hat sie auch den Wiederherstellungs-Schlüssel nicht mehr, löschst du das Konto in der Verwaltungsoberfläche und die Person registriert sich neu: Ihre Verbindungen liegen weiter auf ihren Geräten und werden beim ersten Abgleich wieder hochgeladen; in Teams muss sie neu eingeladen werden. Ein Admin kann kein Passwort setzen, weil der Tresor mit dem Passwort verschlüsselt ist.
Plätze ändern (Team): Anzahl im Kundenportal unter Konto → Eigener Server ändern. Dein Server holt die neue Lizenz innerhalb von sechs Stunden, sofort nach docker compose restart termax-sync. Mit TERMAX_RENEW=0 die Lizenz in der App neu kopieren und in .env eintragen.
Lizenz, Plätze, Überwachung: https://deine-domain/api/termax/server-info zeigt, ob die Lizenz gilt, Stufe, Plätze, belegte Konten und Ablaufdatum. Die Adresse eignet sich auch als Health-Check für Uptime Kuma o. Ä. (Antwort 200 und "licensed":true).
Neue Versionen: stehen in den Versionshinweisen. Der Tag 1 in der Compose-Datei bekommt alle kompatiblen Updates; docker compose pull holt sie.
Von der Termax-Cloud wechseln: deine eigenen Verbindungen, Ordner und Snippets nimmt die App mit. Team-Ordner aus der Termax-Cloud nicht: lege das Team auf deinem Server neu an und verschiebe die Einträge dorthin, solange du sie auf einem Gerät noch hast.
Sicherung zurückspielen: in der Verwaltungsoberfläche unter Settings → Backups → Restore, oder eine Datei von der Kommandozeile (ersetzt alle Daten des Servers):
docker compose stop termax-sync docker compose run --rm --no-deps -T --entrypoint sh termax-sync -c 'cd /pb_data && find . -mindepth 1 -delete && tar xzf -' < termax-backup-DATUM.tgz docker compose start termax-sync
Auf einen anderen Rechner umziehen: Sicherung machen, auf dem neuen Rechner Schritt 1 und 2 mit derselben .env, einmal docker compose up -d und gleich wieder stop termax-sync, Sicherung zurückspielen, DNS-Eintrag umstellen. Die Lizenz gilt pro Abo, nicht pro Rechner.
Neue Domain: TERMAX_DOMAIN und TERMAX_PUBLIC_URL ändern, docker compose up -d. In jeder App abmelden, „Server ändern“, neue Adresse, mit demselben Konto anmelden.
// Schon ein Reverse-Proxy da?
Nginx Proxy Manager, Traefik, Synology, Unraid
Belegt auf deinem Rechner schon ein Reverse-Proxy die Ports 80 und 443, lass den Caddy-Dienst weg und veröffentliche nur den Termax-Port. In docker-compose.yml: den ganzen Block caddy: (und unten caddy-data, caddy-config) löschen, die Datei Caddyfile brauchst du dann nicht, und bei termax-sync statt expose:
ports:
- "127.0.0.1:8090:8090" # Proxy auf demselben Rechner
# - "192.168.1.10:8090:8090" # Proxy auf einem anderen Rechner: LAN-Adresse dieses Rechners
Im Proxy einen Host für deine Domain anlegen, Ziel http://127.0.0.1:8090 (bzw. die LAN-Adresse), mit Zertifikat von Let's Encrypt. Wichtig: Der Proxy muss die Client-Adresse im Header X-Forwarded-For mitschicken (Nginx Proxy Manager, Traefik und Synology tun das von selbst) und Anfragen bis 32 MB durchlassen (Nginx: client_max_body_size 32m; unter „Advanced“). Veröffentliche den Port nie auf 0.0.0.0 ins Internet: dann könnte jeder die Ratenbegrenzung mit einem gefälschten Header umgehen.
TERMAX_DOMAIN wird ohne Caddy nicht gebraucht, TERMAX_PUBLIC_URL schon.
// Ohne öffentliche Adresse
Nur im eigenen Netz oder über Tailscale
Die Apps brauchen ein gültiges HTTPS-Zertifikat, auch im eigenen Netz (Android lässt anderes nicht zu). Am einfachsten mit Tailscale: auf dem Server tailscale serve --bg 8090 statt Caddy, und in der App die Adresse https://name.tailnet-name.ts.net. Dazu in docker-compose.yml beim Dienst termax-sync den Port veröffentlichen (ports: ["127.0.0.1:8090:8090"]) und den Caddy-Dienst weglassen.
Ohne Internetzugang setze TERMAX_RENEW=0 und trage die Lizenz nach jeder Verlängerung (einmal im Jahr) von Hand neu ein.
// Hilfe
Wenn etwas nicht klappt
„Der Server ist nicht erreichbar“: DNS-Eintrag, Ports 80/443 und docker compose logs caddy prüfen (dort steht, ob das Zertifikat geholt wurde).
„Dieser Server hat keine gültige Termax-Lizenz“: docker compose logs termax-sync nennt den Grund; meist fehlt ein Teil der Lizenz-Zeile.
„Registrierung für diese E-Mail-Adresse nicht freigegeben“: Adresse oder Domain in TERMAX_SIGNUP_ALLOW eintragen und docker compose up -d.
„Server schreibgeschützt“: Die Lizenz ist abgelaufen. Abo im Kundenportal prüfen; sobald es läuft, holt sich der Server die neue Lizenz innerhalb von sechs Stunden (oder sofort nach docker compose restart termax-sync).
Noch Fragen? Der Support läuft per E-Mail an support@termax.app. Eine begleitete Einrichtung oder einen Zugriff auf deinen Server bieten wir nicht an.