Befehlsreferenz
Alle Befehle der Plattform-CLI mit Optionen.
Die CLI liegt in tools/platform-cli und läuft über das Root-Skript:
bash
pnpm platform <bereich> <befehl> [optionen]Konfiguration in tools/platform-cli/.env (Vorlage .env.example): Plattform-URL, Agentur-API-Schlüssel, Dokploy-Zugang, Image-Präfix, Backup-Ziel. Die Datei ist gitignored.
#Shops
| Befehl | Was er tut |
|---|---|
shop create <id> --name "<Name>" --owner <email> | Shop anlegen. --target local|dokploy|env, --domain, --no-demo, --force, --dry-run, --build/--no-build |
shop up <id> | Lokalen Shop (neu) starten; veraltete Images werden gebaut |
shop connect <id> | Lokalen Shop nachträglich mit der Plattform verbinden |
shop list | Shops der Plattform |
shop release <id> <tag> | Shop auf ein Release (Image-Tag) umstellen und neu deployen |
shop domains <id> [domain] | Shop-, admin.- und api.-Adressen an Traefik übergeben (erst wenn das DNS stimmt) |
shop sso <id> | „Dashboard öffnen“ (Login über die Plattform) einrichten |
shop diagnose <id> | Diagnose-Bericht als Markdown |
#Releases und Stacks
| Befehl | Was er tut |
|---|---|
release build <tag> [--push] | Alle Images lokal bauen (für Dokploy baut sonst der GitHub-Workflow) |
stack deploy <compose> [tag] | Dokploy-Compose neu deployen, z. B. platform, commerce-infra, shops-infra; mit Tag wird IMAGE_TAG gesetzt |
mail setup [--to <email>] | Echten Mail-Versand einrichten: SMTP prüfen (Testmail), in den Plattform-Stack schreiben – siehe E-Mail-Versand |
dokploy check | Verbindung zu Dokploy prüfen |
dokploy setup [--force] | Infra-Stack (Postgres, Redis, Backup) anlegen bzw. aktualisieren |
#Themes
| Befehl | Was er tut |
|---|---|
theme publish <zip>… [--publish] [--changelog] [--price] [--industry] [--sort=<n>] | Pakete in die Registry laden (neue Version, wenn das Theme existiert) |
theme list | Themes der Registry mit Installationen und Käufen |
#Backups
| Befehl | Was er tut |
|---|---|
backup source <id> --name <label> [--compose] [--file] | Server als Backup-Quelle anbinden (neuer Token, Env setzen, neu deployen) |
backup sources | Quellen mit letztem Lauf und letztem Wiederherstellungstest |
backup run <id> [--verify] | Backup bzw. Wiederherstellungstest auf dem Server anstoßen |
Tipp
Pfade in Argumenten beziehen sich auf das Verzeichnis, aus dem du pnpm platform aufrufst. Negative Zahlen als --sort=-1 schreiben.
Zuletzt aktualisiert am 21. Oktober 2026