Wissensdatenbank

Zinnector®-Befehlsreferenz

Jeder Zinnector®-Befehl genau so, wie zinnector --help ihn auflistet — Argumente, Flags und Standardwerte, ein ausführbares Beispiel und dessen Ausgabe — direkt aus der CLI selbst generiert, damit er nicht von der von Ihnen installierten Version abweichen kann.

Jeder Befehl, den Zinnector® 0.1.6 versteht – insgesamt 43, exakt so, wie zinnector --help sie auflistet – mit seinen Optionen, einem ausführbaren Beispiel und dem, was Sie sehen sollten. Diese Seite wird aus der CLI selbst generiert, sodass sie nicht im Widerspruch zu dem von Ihnen installierten Tool stehen kann; falls ein Befehl hier auf Ihrem Computer fehlt, führen Sie npm install -g zinnector@latest aus.

Bevor Sie beginnen

Installieren Sie es mit npm install -g zinnector unter Node 24 oder neuer, und überprüfen Sie die Installation anschließend mit zinnector --version und zinnector --help. Die Erste-Schritte-Anleitung führt durch die ersten fünf Minuten; diese Seite ist die Referenz, zu der Sie zurückkehren.

Jeder Befehl akzeptiert -h, --help. Diese globalen Optionen stehen vor dem Befehlsnamen:

Option	Funktion
`-V, --version`	Version ausgeben
`--profile <name>`	ein benanntes Anmeldedatenprofil verwenden

Die Befehle

`zinnector new`

Ein WordPress-Projekt grundlegend einrichten, das Sie sofort ausführen können.

zinnector new [options] [name]

Argument	Erforderlich	Beschreibung
`name`	Nein	Verzeichnis, in dem das Projekt erstellt werden soll, und der Name des Projekts – erforderlich, sofern nicht --here

Option	Funktion	Standard
`-t, --template <kind>`	Eines von: site, plugin, theme	`"site"`
`--php <version>`	PHP-Version, für die entwickelt werden soll	`"8.3"`
`--wp <version>`	WordPress-Version für die lokale Laufzeitumgebung	`"latest"`
`--runtime <name>`	playground oder docker	`"playground"`
`--here`	Im aktuellen Verzeichnis anstelle eines neuen Verzeichnisses erstellen

Beispiel

zinnector new my-site

Was Sie sehen — erfasst — 0.1.2 unter Linux

Created my-site  ·  site
──────────────────────────

  + .gitignore
  + README.md
  + wp-content/mu-plugins/000-zinnector-dev.php
  + wp-content/plugins/.gitkeep
  + wp-content/themes/.gitkeep
  + zinnector.json

  php        8.3
  wordpress  latest
  runtime    playground

→ run it:
    cd my-site
    zinnector dev

→ then, when you have a hosting slot:
    zinnector link     # point it at a site
    zinnector check    # pre-flight before you push
    zinnector push

`zinnector dev`

Führen Sie dieses Projekt lokal aus – kein Docker erforderlich.

zinnector dev [options]

Option	Funktion	Standard
`--php <version>`	auszuführende PHP-Version (5.2–8.5 auf playground, 7.4–8.5 auf docker)
`--wp <version>`	WordPress-Version
`-p, --port <port>`	Port für die Bereitstellung
`--runtime <name>`	playground (Standard) oder docker
`--login`	automatisch als Administrator anmelden	`true`
`--no-login`	nicht automatisch anmelden
`--once`	starten, ausgeführte Prozesse melden, dann anhalten
`--yes`	lokale Runtime ohne Nachfrage installieren
`--reset-runtime`	installierte Runtime löschen und erneut installieren
`-v, --verbose`	eigene Ausgabe der Runtime anzeigen

Beispiel

cd my-site
zinnector dev

Was Sie sehen — erfasst — 0.1.2. Beim ersten Durchlauf werden Sie einmalig gefragt, ob die WordPress-Laufzeitumgebung (~570 MB) heruntergeladen werden soll; übergeben Sie --yes, um die Frage zu überspringen

my-site  ·  WordPress Playground (WASM, no Docker)
───────────────────────────────────────────────────

  serving    a WordPress project
  from       /home/you/my-site
  php        8.3
  wordpress  latest

✔ running at http://127.0.0.1:9400
  admin: http://127.0.0.1:9400/wp-admin  (already signed in)

  Ctrl-C to stop

`zinnector login`

Melden Sie sich an – mit Ihrem eigenen Konto im Browser oder mit einem API-Schlüssel.

zinnector login [options]

Option	Funktion	Standardwert
`--profile <name>`	unter einem benannten Profil speichern (Standard: default)
`--api <url>`	Basis-URL der API	`"https://api.zinndigital.com"`
`--api-key`	organisationsbezogenen API-Schlüssel einfügen, anstatt sich selbst anzumelden
`--issuer <url>`	der Anmeldedienst	`"https://auth.zinndigital.com/realms/zinn"`
`--no-browser`	Anmeldelink ausgeben, ohne zu versuchen, einen Browser zu öffnen

Beispiel

zinnector login

Was Sie sehen — der Schlüssel wird an der Eingabeaufforderung eingegeben, niemals in der Befehlszeile. Leiten Sie ihn in CI per Pipe weiter: echo „$ZINN_API_KEY“ | zinnector login --profile ci

Sign in to Zinn Digital®  ·  https://api.zinndigital.com
────────────────────────────────────────────────────

  API key: ••••••••••••••••••••••••••••

✔ signed in as you@example.com (Acme Ltd) — profile “default”
→ next: zinnector sites

`zinnector logout`

Eine gespeicherte Anmeldung vergessen.

zinnector logout [options]

Option	Funktion	Standard
`--profile <name>`	Welches Profil vergessen werden soll (Standard: default)

Beispiel

zinnector logout

Was Sie sehen

✔ signed out of profile “default”

`zinnector whoami`

Zeigt an, als wer diese CLI angemeldet ist und worauf sie zugreifen kann.

zinnector whoami [options]

Option	Funktion	Standard
`--profile <name>`	Ein benanntes Profil verwenden
`--scopes`	Die Berechtigungen auflisten, über die ein API-Schlüssel verfügt
`--json`	Maschinenlesbare Ausgabe

Beispiel

zinnector whoami --scopes

Was Sie sehen – erfasst bei einem echten Durchlauf von 0.1.5 gegen die Produktionsumgebung am 14.09.2026; Domains, IDs und Einmal-Links wurden ersetzt


Signed in  ·  https://api.zinndigital.com
──────────────────────────────────────────
account        you@example.com
as             a person, signed in through the browser
organisations  8 — listed below
mode           live
credential     profile “default”

  · Example Org  owner · 01a00000-0000-7000-8000-000000000000
  · Example Org· 01a00001-0000-7000-8000-000000000001
  · Example Org· 01a00002-0000-7000-8000-000000000002
  · Example Org· 01a00003-0000-7000-8000-000000000003
  · Example Org· 01a00004-0000-7000-8000-000000000004
  · Example Org· 01a00005-0000-7000-8000-000000000005
  · Example Org· 01a00006-0000-7000-8000-000000000006
  · Example Org· 01a00007-0000-7000-8000-000000000007

  scopes belong to API keys — a signed-in person acts with their ROLE in each organisation (shown above).

`zinnector sites`

Listet die Websites auf, die dieser Schlüssel sehen kann.

zinnector sites [options]

Option	Beschreibung	Standard
`--json`	maschinenlesbare Ausgabe
`--status <status>`	nur Websites mit diesem Status

Beispiel

zinnector sites

Was Sie sehen – erfasst bei einem echten Durchlauf von 0.1.5 gegen die Produktionsumgebung am 14.09.2026; Domains, IDs und Einmal-Links wurden ersetzt


Sites  ·  12
─────────────
domain          status  php      target  id
example-2.com   active  php —    fleet   01a00000-0000-7000-8000-000000000000
example-3.com   active  php —    fleet   01a00001-0000-7000-8000-000000000001
example-4.com   active  php —    fleet   01a00002-0000-7000-8000-000000000002
example-5.com   active  php 8.5  fleet   01a00003-0000-7000-8000-000000000003
example-6.com   active  php —    fleet   01a00004-0000-7000-8000-000000000004
example.com     active  php 8.4  fleet   01a00005-0000-7000-8000-000000000005
example-7.com   active  php —    fleet   01a00006-0000-7000-8000-000000000006
example-8.com   active  php 8.5  fleet   01a00007-0000-7000-8000-000000000007
example-9.com   active  php 8.5  fleet   01a00008-0000-7000-8000-000000000008
example-10.com  active  php 8.5  fleet   01a00009-0000-7000-8000-000000000009
example-11.com  active  php 8.5  fleet   01a00010-0000-7000-8000-000000000010
example-12.com  active  php 8.5  fleet   01a00011-0000-7000-8000-000000000011

`zinnector status`

Alles, was die Plattform über eine Website weiß.

zinnector status [options] [site]

Argument	Erforderlich	Beschreibung
`site`	Nein	eine Website-ID, primäre Domain oder Name – standardmäßig die in zinnector.json verknüpfte Website

Option	Funktion	Standardwert
`--json`	maschinenlesbare Ausgabe

Beispiel

zinnector status example.com

Was Sie sehen – erfasst bei einem echten Durchlauf von 0.1.5 gegen die Produktionsumgebung am 14.09.2026; Domains, IDs und Einmal-Links wurden ersetzt


example.com  ·  01a00000-0000-7000-8000-000000000000
────────────────────────────────────────────────────────────────────────
status         active
product line   footprint_free
stack          wordpress
region         fsn1
deploy target  fleet
plan           PBN 10

● PHP
version        8.4
can switch to  8.5, 8.4, 8.3, 8.2, 8.1, 8.0, 7.4

● Quota
disk      188 MB used of 500.0 GB
files     6,313 of 2,000,000
database  1 MB

● Deploy
status         building
target         fleet
repository     —
commit         —
live url       —
last deployed  2026-09-14T01:29:26.991511Z

● WordPress
version     7.1
up to date  yes
multisite   no

`zinnector share`

Geben Sie einer Person Zugriff auf EINE Website – einem Entwickler, einem Designer, einem Kunden.

zinnector share [options] <site> <email>

Argument	Erforderlich	Beschreibung
`site`	Ja	Die freizugebende Website — eine ID, primäre Domain oder ein Name
`email`	Ja	An wen Zugriff gewährt werden soll — per E-Mail wird eine Einladung gesendet, falls noch kein Konto vorhanden ist

Option	Funktion	Standardwert
`--role <role>`	Was die Person tun darf: viewer, editor, manager
`--reason <text>`	Warum der Zugriff benötigt wird — wird zusammen mit der Freigabe für das Audit-Protokoll gespeichert
`--until <date>`	Wann der Zugriff automatisch erlischt (JJJJ-MM-TT); weglassen, wenn der Zugriff bis zum Widerruf gelten soll
`--json`	Maschinenlesbare Ausgabe

Beispiel

zinnector share example.com dev@agency.test --role editor --reason "rebuild the checkout"

Was Sie sehen — die genaue Ausgabe des Befehls, direkt aus der Quelle (W40-DEVTOOL hat diese hinzugefügt, nachdem diese Datei zuletzt erfasst wurde); Ihre Domains, IDs und Daten werden abweichen

Shared example.com  ·  01a03f39-730a-7dc4-84b0-5d4f7582dd04
────────────────────────────────────────────────────────────

✔ invited dev@agency.test as editor
  They have no account yet, so an invitation has been emailed. Until they
  sign in and accept it they can see nothing; the moment they do, the site is theirs.

→ what they do next, on their own machine:
    npm i -g zinnector && zinnector login   # sign in as themselves
    zinnector clone example.com   # pull the files down

`zinnector collaborators`

Wer Zugriff auf eine Website erhalten hat und ob dieser akzeptiert wurde.

zinnector collaborators [options] [site]

Argument	Erforderlich	Beschreibung
`site`	Nein	eine Website-ID, primäre Domain oder Name – standardmäßig die in zinnector.json verknüpfte Website

Option	Funktion	Standardwert
`--json`	maschinenlesbare Ausgabe

Beispiel

zinnector collaborators example.com

Was Sie sehen – erfasst aus einem echten Durchlauf von 0.1.5 gegen die Produktionsumgebung am 2026-09-14; Domains, IDs und Einmal-Links wurden ersetzt. Das genaue Format, das der Befehl ausgibt, direkt aus der Quelle (W40-DEVTOOL hat diese hinzugefügt, nachdem diese Datei zuletzt erfasst wurde); Ihre Domains, IDs und Datumsangaben weichen davon ab


Access to example.com  ·  3
───────────────────────────────────────────────────────────
who              role    status   ends  why                                          grant
dev@agency.test  viewer  revoked  —     Example Org— revoked immediately after       01a00000-0000-7000-8000-000000000000
dev@agency.test  viewer  revoked  —     Example Org— revoked at the end of the walk  01a00001-0000-7000-8000-000000000001
dev@agency.test  editor  revoked  —     Example Org— revoked at the end of the walk  01a00002-0000-7000-8000-000000000002

`zinnector unshare`

Entziehen Sie einer Person den Zugriff auf eine Website – per E-Mail oder Freigabe-ID.

zinnector unshare [options] <site> <who>

Argument	Erforderlich	Beschreibung
`site`	ja	die Website, deren Zugriff entzogen werden soll — eine ID, primäre Domain oder ein Name
`who`	ja	die zu entfernende Person — deren E-Mail-Adresse oder die Berechtigungs-ID aus zinnector collaborators

Option	Beschreibung	Standard
`--yes`	nicht nachfragen

Beispiel

zinnector unshare example.com dev@agency.test --yes

✔ withdrew the invitation to dev@agency.test

`zinnector invitations`

Die auf Sie wartenden Einladungen, und nehmen Sie eine an.

zinnector invitations [options] [command]

Beispiel

zinnector invitations

Was Sie sehen — erfasst bei einem echten Durchlauf von 0.1.5 gegen die Produktion am 14.09.2026; Domains, IDs und Einmal-Links wurden ersetzt. Die exakte Ausgabe des Befehls, direkt aus der Quelle (W40-DEVTOOL hat diese hinzugefügt, nachdem diese Datei zuletzt erfasst wurde); Ihre Domains, IDs und Daten werden abweichen; ohne Unterbefehl wird list ausgeführt


Invitations  ·  0
──────────────────

● nothing waiting for you

`zinnector invitations list`

Einladungen, die an das Konto gerichtet sind, mit dem Sie angemeldet sind.

zinnector invitations list [options]

Option	Funktion	Standard
`--json`	maschinenlesbare Ausgabe

Beispiel

zinnector invitations list


Invitations  ·  0
──────────────────

● nothing waiting for you

`zinnector invitations accept`

Nehmen Sie eine Einladung an – die Website gehört Ihnen, sobald dies abgeschlossen ist.

zinnector invitations accept [options] <id>

Argument	Erforderlich	Beschreibung
`id`	Ja	Die Einladungs-ID aus zinnector invitations – ein eindeutiges Präfix davon reicht aus

Beispiel

zinnector invitations accept 01a03f39-9c11-7b02-a7e0-2e4d0c5f1b77

✔ you now have access to example.com

`zinnector link`

Verknüpfen Sie dieses Projekt mit einem Hosting-Slot (und verbinden Sie dessen Repository).

zinnector link [options] [site]

Argument	Erforderlich	Beschreibung
`site`	Nein	Eine Site-ID, primäre Domain oder Name – standardmäßig die in zinnector.json verknüpfte Site

Option	Funktion	Standardwert
`--repo <owner/name>`	Dieses Repository mit der Site auf der Plattform verbinden
`--provider <name>`	Das verbundene Konto für das Deployment: github_app, github oder gitlab (Standardwert: das von Ihrer Organisation verbundene)
`--branch <name>`	Branch, von dem aus ein Push bereitgestellt wird
`--no-repo`	Nur zinnector.json schreiben; die Plattform nicht verändern

Beispiel

zinnector link example.com --repo acme/example-site --branch main

Was Sie sehen

✔ this project deploys to example.com (01a03f39-730a-7dc4-84b0-5d4f7582dd04)
  written to zinnector.json — commit it so everyone deploys to the same slot
✔ the platform will deploy acme/example-site (main)
→ next: zinnector check

`zinnector pull`

Übertragen Sie die Dateien einer gehosteten Website für die lokale Entwicklung in dieses Projekt – und führen Sie den Befehl erneut aus, um erneut zu synchronisieren.

zinnector pull [options] [site]

Argument	Erforderlich	Beschreibung
`site`	Nein	Eine Website-ID, primäre Domain oder ein Name – standardmäßig die in zinnector.json verknüpfte Website

Option	Funktion	Standardwert
`--via <seam>`	auto (Standard), git oder backup	`"auto"`
`--fresh`	Erstellt ein neues Backup, anstatt das neueste zu verwenden (verbraucht einen On-Demand-Slot)
`--max-age <hours>`	Akzeptiert das neueste Backup, wenn es jünger als dieser Wert ist	`"24"`
`--full`	Das gesamte Document-Root, einschließlich WordPress-Core (Standard: nur wp-content)
`--no-uploads`	wp-content/uploads (Medien) auslassen
`--no-database`	Die Datenbank der Website auslassen – nur die Dateien übernehmen
`--live-config`	Auch wp-config.php schreiben – enthält die LIVE-Datenbank-Zugangsdaten
`--clean`	Leert wp-content vor dem Entpacken, sodass Löschungen auf der Website übernommen werden
`--dry-run`	Zeigt an, was passieren würde, und stoppt
`--yes`	Nicht nachfragen

Beispiel

zinnector pull

Was Sie sehen

Pull example.com  ·  01a03f39-730a-7dc4-84b0-5d4f7582dd04
─────────────────────────────────────────────────────────────

● via git — the site syncs to its own repository and this is a clone of it
✔ fast-forwarded 3 commits 4f1c2a9b → 9d2e7c14

● not synced, and why
  ✖ database                     the local playground has its own; the site's is not copied
  ✖ offloaded media              objects in storage are not in the site's files
  ✖ anything outside the repository  only wp-content syncs

→ next: zinnector dev

`zinnector clone`

Erstellen Sie ein lokales Projekt aus einer gehosteten Website: Klonen Sie deren Repository oder laden Sie deren Dateien herunter.

zinnector clone [options] <site> [dir]

Argument	Erforderlich	Beschreibung
`site`	ja	die zu kopierende gehostete Website – eine ID, primäre Domain oder ein Name
`dir`	nein	zu erstellendes Verzeichnis – standardmäßig die primäre Domain der Website

Option	Funktion	Standardwert
`--via <seam>`	auto (Standard), git oder backup	`"auto"`
`--fresh`	ein neues Backup erstellen, anstatt das neueste zu verwenden
`--full`	das gesamte Document-Root, einschließlich WordPress-Core
`--no-uploads`	wp-content/uploads (Medien) auslassen
`--no-database`	die Datenbank der Website auslassen – nur die Dateien übernehmen
`--live-config`	auch wp-config.php schreiben – enthält die LIVE-Datenbank-Zugangsdaten
`--yes`	nicht nachfragen

Beispiel

zinnector clone client.example.com

Was Sie sehen

Clone client.example.com  ·  client.example.com
──────────────────────────────────────────────────────

✔ wrote client.example.com/zinnector.json (php 8.3, wordpress 6.7.1)
● via backup — the site does not sync to a repository
✔ downloaded 214 MB and extracted wp-content

● not synced, and why
  ✖ database                     the local playground has its own; the site's is not copied
  ✖ offloaded media              objects in storage are not in the site's files
  ✖ wp-config.php                holds the live database credentials (--live-config to write it)
  ✖ WordPress core               the runtime supplies the version the slot runs (--full to take it)

→ next: zinnector dev

→ run it:
    cd client.example.com
    zinnector dev

`zinnector sync`

Bidirektionale Synchronisierung zwischen den Live-Dateien einer Website und ihrem Repository.

zinnector sync [options] [command]

Beispiel

zinnector sync --help

Was Sie sehen – ohne Unterbefehl entspricht zinnector sync <site> dem Befehl sync status

Usage: zinnector sync [options] [command]

two-way sync between a site's live files and its repository

  site → repository   zinnector sync run   commits the live files and pushes the branch
  repository → site   zinnector push       builds the branch and publishes it

`zinnector sync status`

Status der bidirektionalen Synchronisierung und ihre letzten Durchläufe.

zinnector sync status [options] [site]

Argument	Erforderlich	Beschreibung
`site`	Nein	eine Website-ID, primäre Domain oder Name – standardmäßig die in zinnector.json verknüpfte Website

Option	Funktion	Standardwert
`--json`	maschinenlesbare Ausgabe

Beispiel

zinnector sync status example.com

Was Sie sehen – erfasst bei einem echten Durchlauf von 0.1.4 auf einer Testseite am 12.09.2026; die Domain und IDs wurden durch Beispielwerte ersetzt

Two-way sync — example.com
──────────────────────────

repository   acme/example-site (main)
available    yes
sync         on
state        synced
last sync    2026-09-12T22:51:41.539832Z
note         Started from acme/example-site@main.

run        files       commit         when
synced     2 changed   da85d73cef5f   2026-09-12T22:52:10.117301Z

`zinnector sync on`

Aktivieren Sie die Zwei-Wege-Synchronisierung (überträgt von selbst keine Daten).

zinnector sync on [options] [site]

Argument	Erforderlich	Beschreibung
`site`	Nein	Eine Website-ID, primäre Domain oder Name – standardmäßig die in zinnector.json verknüpfte Website

Option	Funktion	Standardwert
`--subdir <path>`	Synchronisiert nur dieses Unterverzeichnis der Website
`--json`	Maschinenlesbare Ausgabe

Beispiel

zinnector sync on example.com

Was Sie sehen – erfordert ein verknüpftes Repository in Ihrem eigenen GitHub-Konto; es überträgt von selbst nichts

✔ two-way sync is on

Two-way sync — example.com
…
→ next: zinnector sync run

`zinnector sync off`

Schalten Sie die bidirektionale Synchronisierung aus.

zinnector sync off [options] [site]

Argument	Erforderlich	Beschreibung
`site`	Nein	Eine Website-ID, primäre Domain oder Name – standardmäßig die in zinnector.json verknüpfte Website

Option	Funktion	Standardwert
`--subdir <path>`	Synchronisiert nur dieses Unterverzeichnis der Website
`--json`	Maschinenlesbare Ausgabe

Beispiel

zinnector sync off example.com

Was Sie sehen

✔ two-way sync is off

`zinnector sync run`

Übertragen Sie die Live-Dateien der Website jetzt per Commit in ihr Repository.

zinnector sync run [options] [site]

Argument	Erforderlich	Beschreibung
`site`	Nein	eine Website-ID, primäre Domain oder Name – standardmäßig die in zinnector.json verknüpfte Website

Option	Funktion	Standardwert
`--json`	maschinenlesbare Ausgabe

Beispiel

zinnector sync run example.com

Was Sie sehen – erfasst aus einem echten Durchlauf von 0.1.4 auf einer Testseite am 2026-09-12; die Domain und IDs wurden durch Beispielwerte ersetzt. Ein Durchlauf, über den das Repository bereits hinausgegangen ist, wird stattdessen auf HELD gesetzt: Es wird nichts übertragen (gepusht) oder überschrieben, der Befehl wird mit dem Exit-Code 1 beendet und nennt den nächsten Schritt.

✔ committed 2 changed files da85d73cef5f

Two-way sync — example.com
…
→ next: git pull in your clone

`zinnector sync resolve`

Lösen Sie eine angehaltene Synchronisierung auf, indem Sie auswählen, welche Seite gewinnt.

zinnector sync resolve [options] [site]

Argument	Erforderlich	Beschreibung
`site`	Nein	Eine Website-ID, primäre Domain oder Name – standardmäßig die in zinnector.json verknüpfte Website

Option	Funktion	Standardwert
`--keep <side>`	site (die Website darüber committen) oder repository (die nicht synchronisierten Änderungen der Website verwerfen)
`--yes`	Nicht nachfragen
`--json`	Maschinenlesbare Ausgabe

Beispiel

zinnector sync resolve example.com --keep repository --yes

Was Sie sehen – erfasst bei einem echten Durchlauf von 0.1.4 auf einer Testseite am 12.09.2026; Domain und IDs wurden durch Beispielwerte ersetzt. Ohne --yes wird zuerst nachgefragt und gänzlich abgelehnt, wenn kein Terminal für die Abfrage vorhanden ist

✔ kept the repository

Two-way sync — example.com
…
state        synced

`zinnector check`

Vergleichen Sie dieses Projekt mit dem Slot, auf dem Sie die Bereitstellung durchführen möchten.

zinnector check [options] [site]

Argument	Erforderlich	Beschreibung
`site`	Nein	Eine Website-ID, primäre Domain oder ein Name – standardmäßig die in zinnector.json verknüpfte Website

Option	Funktion	Standard
`--probe`	Die lokale Laufzeitumgebung starten und deren PHP MESSEN, anstatt zinnector.json zu vertrauen
`--all`	Auch bestandene Prüfungen anzeigen
`--strict`	Auch fehlschlagen, wenn etwas nicht überprüft werden konnte
`--json`	Maschinenlesbare Ausgabe

Beispiel

zinnector check

Was Sie sehen – erfasst bei einem echten Durchlauf von 0.1.5 in der Produktionsumgebung am 14.09.2026; Domains, IDs und Einmal-Links wurden ersetzt – der Durchlauf ergab eine tatsächliche Abweichung (PHP 8.3 im Projekt gegenüber 8.4 auf dem Slot), was genau der Zweck des Befehls ist

→ reading the slot
  size excludes: .git

Pre-flight — example.com  ·  01a00000-0000-7000-8000-000000000000
────────────────────────────────────────────────────────────────────────

  local  php 8.4  3 files, 0.0 MB
  slot   php 8.4  target fleet
  local php is the version DECLARED in zinnector.json — run with --probe to measure it

  ? unknown   local php extensions could not be enumerated
      try zinnector dev --once

  ? unknown   wordpress versions could not be compared
      No WordPress version found in the working copy.
      try zinnector status

  7 passed  ·  2 could not be checked

`zinnector push`

Führen Sie Vorabprüfungen durch, übertragen Sie Ihre Commits und stellen Sie sie bereit.

zinnector push [options] [site]

Argument	Erforderlich	Beschreibung
`site`	Nein	Eine Site-ID, primäre Domain oder Name – standardmäßig die in zinnector.json verknüpfte Site

Option	Funktion	Standard
`-f, --force`	Bereitstellung auch dann durchführen, wenn die Vorabprüfung Auffälligkeiten meldet
`--skip-checks`	Vorabprüfung überhaupt nicht ausführen
`--probe`	Die lokale Laufzeit während der Vorabprüfung messen, anstatt zinnector.json zu vertrauen
`--no-wait`	Bereitstellung anstoßen und beenden, ohne sie zu überwachen
`--no-git`	Keinen git push ausführen; den aktuellen Stand der Plattform bereitstellen
`--dry-run`	Alles außer der Bereitstellung ausführen

Beispiel

zinnector push

Was Sie sehen

Deploy to example.com  ·  01a03f39-730a-7dc4-84b0-5d4f7582dd04
───────────────────────────────────────────────────────────────

✔ pre-flight: 8 passed  ·  0 to look at  ·  2 could not be checked
→ pushing main (4f1c2a9b add the contact form)
✔ pushed
● deploy 7c0e… started — watching
✔ deployed 4f1c2a9b in 48s

  status    success
  commit    4f1c2a9b
  url       https://example.com

`zinnector deploy`

Stellen Sie das, was die Plattform bereits hat, ohne Push erneut bereit.

zinnector deploy [options] [site]

Argument	Erforderlich	Beschreibung
`site`	Nein	Eine Website-ID, primäre Domain oder Name – standardmäßig die in zinnector.json verknüpfte Website

Option	Funktion	Standard
`--no-wait`	Auslösen und beenden

Beispiel

zinnector deploy example.com

Was Sie sehen – erfasst bei einem echten Durchlauf von 0.1.5 gegen die Produktionsumgebung am 14.09.2026; Domains, IDs und Einmal-Links wurden ersetzt


Redeploy example.com  ·  01a00000-0000-7000-8000-000000000000
────────────────────────────────────────────────────────────────────────
→ starting the deploy
✔ deploy started

`zinnector deploys`

Der Bereitstellungsverlauf einer Website.

zinnector deploys [options] [site]

Argument	Erforderlich	Beschreibung
`site`	Nein	Eine Website-ID, primäre Domain oder ein Name – standardmäßig die in zinnector.json verknüpfte Website

Option	Funktion	Standardwert
`--json`	Maschinenlesbare Ausgabe
`-n, --limit <n>`	Anzahl der anzuzeigenden Einträge	`"10"`

Beispiel

zinnector deploys example.com

Was Sie sehen – erfasst bei einem echten Durchlauf von 0.1.5 gegen die Produktionsumgebung am 14.09.2026; Domains, IDs und Einmal-Links wurden ersetzt


Deploys — example.com  ·  2
───────────────────────────────────────────────────────────
status  commit  branch  trigger  started                      message
live    —       —       manual   2026-09-14T09:06:39.685554Z  —
live    —       —       manual   2026-09-14T01:29:20.196957Z  —

`zinnector php`

Die PHP-Version einer Website anzeigen oder wechseln.

zinnector php [options] [version]

Argument	Erforderlich	Beschreibung
`version`	Nein	die PHP-Version, auf die die Website umgestellt werden soll, z. B. 8.4 – weglassen, um die aktuelle anzuzeigen

Option	Funktion	Standard
`-s, --site <site>`	Website-ID oder Domain
`--list`	die von der Plattform angebotenen Versionen auflisten
`--json`	maschinenlesbare Ausgabe

Beispiel

zinnector php 8.3 --site example.com

Was Sie sehen — erfasst bei einem echten Durchlauf von 0.1.5 gegen die Produktionsumgebung am 14.09.2026; Domains, IDs und Einmal-Links wurden ersetzt. Ohne Versionsangabe wird die aktuelle Version angezeigt; --list zeigt, was die Plattform für die Produktlinie dieser Website anbietet


PHP — example.com
──────────────────────────────────────────────────────
version        8.4
can switch to  8.5, 8.4, 8.3, 8.2, 8.1, 8.0, 7.4

`zinnector quota`

Nutzung von Speicherplatz, Dateien und Datenbanken im Vergleich zum im Tarif enthaltenen Kontingent.

zinnector quota [options] [site]

Argument	Erforderlich	Beschreibung
`site`	Nein	eine Website-ID, primäre Domain oder Name – standardmäßig die in zinnector.json verknüpfte Website

Option	Funktion	Standardwert
`--json`	maschinenlesbare Ausgabe

Beispiel

zinnector quota example.com

Was Sie sehen – erfasst bei einem echten Durchlauf von 0.1.5 gegen die Produktionsumgebung am 14.09.2026; Domains, IDs und Einmal-Links wurden ersetzt


Quota — example.com
────────────────────────────────────────────────────────
disk used      188 MB
disk limit     500.0 GB
disk granted   500 GB  (per_site)
files used     6,313
file limit     2,000,000
database       1 MB

  “limit” is what is enforced today; “granted” is what the plan says.

`zinnector db`

Datenbankgröße sowie Einmal-Links zu phpMyAdmin und zum Dateimanager.

zinnector db [options] [site]

Argument	Erforderlich	Beschreibung
`site`	Nein	eine Website-ID, primäre Domain oder Name – standardmäßig die in zinnector.json verknüpfte Website

Option	Funktion	Standardwert
`--json`	maschinenlesbare Ausgabe

Beispiel

zinnector db example.com

Was Sie sehen – erfasst bei einem echten Durchlauf von 0.1.5 gegen die Produktionsumgebung am 14.09.2026; Domains, IDs und Einmal-Links wurden ersetzt. Die Links zu phpMyAdmin und zum Dateimanager sind nur einmalig gültig und laufen ab; fügen Sie sie nirgendwo ein


Database — example.com
───────────────────────────────────────────────────────────
size    1 MB
tables  14

  single-use links, valid for one visit:
  phpMyAdmin    https://pma.example.com/signon.php?t=<single-use>
  file manager  https://files.example.com/signon.php?t=<single-use>

`zinnector logs`

Verfolgen Sie die Zugriffs- und Fehlerprotokolle einer Website in Echtzeit.

zinnector logs [options] [site]

Argument	Erforderlich	Beschreibung
`site`	Nein	Eine Website-ID, primäre Domain oder ein Name – standardmäßig die in zinnector.json verknüpfte Website

Option	Funktion	Standard
`--access`	Nur das Access-Protokoll
`--error`	Nur das Fehlerprotokoll
`--build`	Stattdessen das Build-Protokoll der letzten Bereitstellung
`--json`	Maschinenlesbare Ausgabe

Beispiel

zinnector logs example.com --error

Was Sie sehen — erfasst bei einem echten Durchlauf von 0.1.5 gegen die Produktionsumgebung am 14.09.2026; Domains, IDs und Einmal-Links wurden ersetzt. --access für das Zugriffsprotokoll, --build für das Build-Protokoll der letzten Bereitstellung (eine Website, die nicht von einem Build-Anbieter erstellt wurde, zeigt die eigenen Schritte der Bereitstellung an); ohne Flag werden beide Website-Protokolle angezeigt, und ein Protokoll, das nicht gelesen werden konnte, weist darauf hin, anstatt leer zu wirken


Error log — example.com
────────────────────────────────────────────────────────────

2026-09-14 11:06:07.153643 [NOTICE] [1929978] [T0] [config:vhost:zcaffb6eec5abbdab03fb9b2d62a15:epsr:lsphp-zcaffb6eec5abbdab03fb9b2d62a15]'Process Limit' probably is too low, adjust the limit to: 640.
2026-09-14 11:06:37.873060 [INFO] [1929982] [T0] [lsphp-zcaffb6eec5abbdab03fb9b2d62a15] add child process pid: 1933036, procinfo: 0x5555561cfe30

`zinnector wp`

Führen Sie einen zulässigen WP-CLI-Befehl auf einer Website aus.

zinnector wp [options] [command...]

Argument	Erforderlich	Beschreibung
`command...`	Nein	der WP-CLI-Befehl und seine Argumente, z. B. plugin list – bei --commands weglassen

Option	Funktion	Standard
`-s, --site <site>`	Website-ID oder Domain
`--commands`	auflisten, was die Plattform ausführen wird
`--json`	maschinenlesbare Ausgabe

Beispiel

zinnector wp plugin list --site example.com

Was Sie sehen — erfasst bei einem echten Durchlauf von 0.1.5 gegen die Produktionsumgebung am 2026-09-14; Domains, IDs und Einmal-Links wurden ersetzt. Die Zulassungsliste wird von der Plattform bereitgestellt — zinnector wp --commands gibt sie aus

name	status	update	version	update_version	auto_update
akismet	inactive	none	5.7.2		off
hello	inactive	none	1.7.2		off
imunify-security	active	none	4.1.0		off
litespeed-cache	active	none	7.9.1		off
redis-cache	active	none	2.8.0		off
zinn-cache	active	none	1.2.2		off
object-cache.php	dropin				off

`zinnector backup`

Website-Backups auflisten und erstellen.

zinnector backup [options] [command]

Beispiel

zinnector backup list example.com

Was Sie sehen – erfasst bei einem echten Durchlauf von 0.1.5 in der Produktionsumgebung am 14.09.2026; Domains, IDs und Einmal-Links wurden ersetzt. backup allein gibt die zugehörigen Unterbefehle aus; siehe backup list und backup now unten


Backups — example.com  ·  3
───────────────────────────────────────────────────────────
status  taken                        size    id
stored  2026-09-14T09:06:39.918280Z  4.7 MB  01a00000-0000-7000-8000-000000000000
stored  2026-09-14T01:29:20.403161Z  36 MB   01a00001-0000-7000-8000-000000000001
stored  2026-09-14T01:29:15.898099Z  36 MB   01a00002-0000-7000-8000-000000000002

daily backups   on
retention       30 days
off-site copy   yes
on-demand left  2 of 3

`zinnector backup list`

Listen Sie die Backups einer Website auf und zeigen Sie an, was ihr Tarif umfasst.

zinnector backup list [options] [site]

Argument	Erforderlich	Beschreibung
`site`	Nein	eine Website-ID, primäre Domain oder Name – standardmäßig die in zinnector.json verknüpfte Website

Option	Funktion	Standardwert
`--json`	maschinenlesbare Ausgabe

Beispiel

zinnector backup list example.com

Was Sie sehen – erfasst bei einem echten Durchlauf von 0.1.5 gegen die Produktionsumgebung am 14.09.2026; Domains, IDs und Einmal-Links wurden ersetzt


Backups — example.com  ·  3
───────────────────────────────────────────────────────────
status  taken                        size    id
stored  2026-09-14T09:06:39.918280Z  4.7 MB  01a00000-0000-7000-8000-000000000000
stored  2026-09-14T01:29:20.403161Z  36 MB   01a00001-0000-7000-8000-000000000001
stored  2026-09-14T01:29:15.898099Z  36 MB   01a00002-0000-7000-8000-000000000002

daily backups   on
retention       30 days
off-site copy   yes
on-demand left  2 of 3

`zinnector backup now`

Erstellen Sie ein On-Demand-Backup.

zinnector backup now [options] [site]

Argument	erforderlich	Beschreibung
`site`	nein	eine Website-ID, primäre Domain oder ein Name – standardmäßig die in zinnector.json verknüpfte Website

Beispiel

zinnector backup now example.com

Was Sie sehen

✔ backup started — zinnector backup list example.com shows it when it completes

`zinnector domains`

Listen Sie die Domains auf, die dieser Schlüssel sehen kann.

zinnector domains [options]

Option	Funktion	Standard
`--json`	maschinenlesbare Ausgabe

Beispiel

zinnector domains

Was Sie sehen – erfasst bei einem echten Durchlauf von 0.1.5 gegen die Produktionsumgebung am 14.09.2026; Domains, IDs und Einmal-Links wurden ersetzt


Domains  ·  1
──────────────
domain       status     ownership  renewal        expires
example.com  connected  connected  no auto-renew  —

`zinnector dns`

DNS-Einträge lesen und ändern.

zinnector dns [options] [command]

Beispiel

zinnector dns list example.com

Was Sie sehen – erfasst aus einem echten Durchlauf von 0.1.5 gegen die Produktionsumgebung am 14.09.2026; Domains, IDs und Einmal-Links wurden ersetzt. dns allein gibt seine Unterbefehle aus; siehe dns list, dns add und dns rm unten


DNS — example.com  ·  1 records
────────────────────────────────────────
type  name          value               ttl
TXT   w4357-verify  zinn-w4357-updated  ttl 3600

`zinnector dns list`

Listet die DNS-Einträge einer Domain auf.

zinnector dns list [options] <domain>

Argument	Erforderlich	Beschreibung
`domain`	Ja	Die Domain, nach Name oder ID

Option	Funktion	Standard
`--type <type>`	Nur Einträge dieses Typs
`--json`	Maschinenlesbare Ausgabe

Beispiel

zinnector dns list example.com

Was Sie sehen – erfasst bei einem echten Durchlauf von 0.1.5 gegen die Produktionsumgebung am 14.09.2026; Domains, IDs und Einmal-Links wurden ersetzt


DNS — example.com  ·  1 records
────────────────────────────────────────
type  name          value               ttl
TXT   w4357-verify  zinn-w4357-updated  ttl 3600

`zinnector dns add`

Erstellen Sie einen DNS-Eintrag.

zinnector dns add [options] <domain> <type> <name> <value>

Argument	Erforderlich	Beschreibung
`domain`	ja	die Domain nach Name oder ID
`type`	ja	Eintragstyp: A, AAAA, CNAME, MX, TXT, SRV, …
`name`	ja	der Eintragsname – @ für die Domain selbst oder eine Subdomain-Bezeichnung
`value`	ja	worauf der Eintrag verweist – eine Adresse, ein Hostname oder Text

Option	Funktion	Standard
`--ttl <seconds>`	Time to Live	`"3600"`
`--priority <n>`	Priorität für MX und SRV
`--proxied`	über das CDN leiten
`-y, --yes`	nicht nachfragen

Beispiel

zinnector dns add example.com TXT _acme "token" --ttl 300

Was Sie sehen – der Eintrag wird angezeigt und bestätigt, bevor er geschrieben wird; übergeben Sie --yes, um die Abfrage zu überspringen

Add a DNS record to example.com
───────────────────────────────

  type   TXT
  name   _acme
  value  "token"
  ttl    300

  create it? [y/N] y
✔ created TXT _acme

`zinnector dns rm`

Einen DNS-Eintrag löschen.

zinnector dns rm [options] <domain> <recordId>

Argument	erforderlich	Beschreibung
`domain`	ja	die Domain, nach Name oder ID
`recordId`	ja	die Datensatz-ID, wie zinnector dns list sie ausgibt

Option	Funktion	Standardwert
`-y, --yes`	nicht nachfragen

Beispiel

zinnector dns rm example.com rec_7f3a

Was Sie sehen

⚠ deleting A @ 203.0.113.10 from example.com
  delete it? [y/N] y
✔ deleted

`zinnector mail`

E-Mail-Dienste auflisten.

zinnector mail [options]

Option	Funktion	Standard
`--json`	maschinenlesbare Ausgabe

Beispiel

zinnector mail

Was Sie sehen – erfasst bei einem echten Durchlauf von 0.1.5 gegen die Produktionsumgebung am 14.09.2026; Domains, IDs und Einmal-Links wurden ersetzt


Mail services  ·  0
────────────────────

● no mail services

`zinnector bulk`

Führen Sie eine Operation auf mehreren Websites aus (cache_purge, malware_scan, sitemap, block_ip).

zinnector bulk [options] <operation>

Argument	Erforderlich	Beschreibung
`operation`	ja	Was auf jeder ausgewählten Website ausgeführt werden soll: cache_purge, malware_scan, sitemap oder block_ip

Option	Funktion	Standardwert
`--all`	Jede Website, die dieser Schlüssel sehen kann
`--site <site...>`	Bestimmte Websites nach ID oder Domain
`--status <status>`	Jede Website mit diesem Status
`-y, --yes`	Nicht nachfragen
`--json`	Maschinenlesbare Ausgabe

Beispiel

zinnector bulk cache_purge --all

Was Sie sehen – erfasst aus einem echten Durchlauf von 0.1.5 gegen die Produktionsumgebung am 14.09.2026; Domains, IDs und Einmallinks wurden ersetzt. Ein einziger Aufruf an die Plattform für die gesamte Auswahl, nicht einer pro Website; die Auswahl wird zuerst angezeigt und bestätigt


Bulk cache_purge  ·  1 sites
─────────────────────────────

·   example.com

→ running cache_purge
✔ cache_purge accepted for 1 sites

  The platform runs this asynchronously; results appear per site in the dashboard.

`zinnector ai`

Fragen Sie den Zinn Digital®-Assistenten mit diesem Projekt als Kontext.

zinnector ai [options] <question...>

Argument	Erforderlich	Beschreibung
`question...`	Ja	Was Sie fragen möchten, in einfachen Worten – Anführungszeichen sind optional

Option	Funktion	Standard
`-s, --site <site>`	Zu einer bestimmten Website fragen
`--org <id>`	Die Organisation, in deren Namen gefragt werden soll, wenn Ihr Konto zu mehr als einer gehört
`--no-context`	Nichts über das lokale Projekt senden
`--json`	Maschinenlesbare Ausgabe

Beispiel

zinnector ai "why is my deploy failing?"

Was Sie sehen — erfasst bei einem echten Durchlauf von 0.1.5 auf der Produktionsumgebung am 14.09.2026; Domains, IDs und Einmal-Links wurden ersetzt. Der Assistent antwortet in der Sprache des KONTOS — das Gebietsschema dieses Kontos ist Arabisch, daher ist die erfasste Antwort auf Arabisch zu einer englischen Frage

→ thinking

Zinn Digital® assistant
────────────────────────────

  هذا مشروع WordPress تم إنشاؤه بواسطة Zinnector® (مُهيّأ على PHP 8.4، أحدث
  إصدار WordPress، وبيئة تشغيل playground)؛ لتشغيله محلياً، انتقل إلى مجلده
  وشغّل الأمر: cd <اسم-المشروع> ثم zinnector dev، وسيقوم بتشغيل موقع WordPress
  حقيقي على جهازك دون الحاجة إلى Docker.

  sources:
    · https://zinndigital.com/kb/zinnector-getting-started
    · https://zinndigital.com/kb/zinnector-local-development

`zinnector mcp`

Führen Sie eine stdio-Bridge zum gehosteten MCP-Server aus – für Claude Desktop und andere rein lokale Clients.

zinnector mcp [options]

Beispiel

ZINN_MCP_TOKEN=zmcp_live_… zinnector mcp

Was Sie sehen – gestartet VON einem KI-Client wie Claude Desktop, niemals manuell – spricht MCP über stdin und stdout. Verifiziert über Claude Code 2.1.270 auf dem Live-Server am 12.09.2026

zinnector 0.1.4: MCP bridge to https://api.zinndigital.com/v1/mcp

Umgebungsvariablen

Variable	Auswirkung
`ZINNECTOR_TOKEN`	ein API-Schlüssel, der anstelle eines gespeicherten Profils verwendet wird – so authentifiziert sich CI
`ZINNECTOR_API`	API-Basis-URL (Standard: `https://api.zinndigital.com`)
`ZINNECTOR_DEBUG=1`	Stack-Traces und die eigene Ausgabe des Laufzeit-Installers ausgeben
`ZINNECTOR_CACHE_DIR`	Speicherort für die WordPress-Laufzeitumgebung und jedes verwaltete Node (Standard: `~/.cache/zinnector`)
`ZINNECTOR_CONFIG_DIR`	Speicherort der Profildatei für den API-Schlüssel (Standard: `~/.config/zinnector`)
`NO_COLOR`	Farben deaktivieren

Exit-Codes

0 Erfolg · 1 ein Befund oder eine Ablehnung · 70 ein interner Fehler · 77 Authentifizierung oder Berechtigung · 78 nicht unterstütztes Node.

Alle Entwicklerdokumentationen →

Neuestes aus dem Blog

Was wir über Hosting, SEO und den Betrieb von Websites in großem Umfang geschrieben haben.

SEO und Linkbuilding aus der Hosting-Ebene: Die Sicht eines Betreibers im Jahr 2026

Wie Hosting die Indexierung und das Link-Equity im Jahr 2026 beeinflusst: Seiten im Index halten, gealterte Domains vor der Nutzung prüfen, Linkbuilding ohne SEO-Footprint und eine ehrliche Einschätzung dessen, was Infrastruktur für SEO leisten kann und was nicht.

21. Juli 2026

Beitrag lesen →

WordPress schnell und sicher machen: Eine Checkliste für Leistung und Plugins

Eine praktische Checkliste für ein schnelles, sicheres WordPress: Caching auf Serverebene, ein objektbasierter Cache pro Website, die Handvoll Plugins, deren Einsatz sich lohnt, die Aktualisierung des Software-Stacks und die WooCommerce-Seiten, die Sie niemals cachen dürfen.

20. Juli 2026

Beitrag lesen →

So wählen Sie Managed Webhosting im Jahr 2026 aus: Ein Einkaufsratgeber

Was gutes Managed Hosting tatsächlich von einer billigen Box mit Control Panel unterscheidet — Migrationen, Backups, Isolation, echtes Caching und ehrliche Skalierung — und wie Sie dies beurteilen können, bevor Sie sich festlegen.

19. Juli 2026

Beitrag lesen →

Blog lesen →

Benötigen Sie weiterhin Hilfe?

Der Support ist in jedem Tarif enthalten, das Team ist 24 Stunden am Tag für Sie da und Sie können uns in jeder unserer 58 Sprachen schreiben – wir antworten Ihnen in Ihrer Sprache.

Support kontaktieren → Alle Artikel →