Wissensdatenbank
Die Fehler, auf die man bei der Zinnector® CLI tatsächlich stößt, und die Lösung für jeden einzelnen: spawn EINVAL unter Windows, die EBADENGINE-Warnung von npm, die Anforderung von Visual Studio durch node-gyp unter Node 26, EPERM während der Installation, eine Laufzeitumgebung, die nicht startet, und ein belegter Port.
Die Fehler, auf die Nutzer bei der Zinnector®-CLI tatsächlich stoßen, was sie jeweils bedeuten und die Lösung dazu. Jeder Eintrag nennt den genauen Text, den Sie sehen werden, sodass Sie diese Seite danach durchsuchen können. Falls Ihrer hier nicht aufgeführt ist, führen Sie den fehlschlagenden Befehl mit ZINNECTOR_DEBUG=1 aus und eröffnen Sie ein Issue auf github.com/Zinn-Digital/zinnector/issues mit der Ausgabe, Ihrer Angabe zu node --version sowie Ihrem Betriebssystem.
Ein Fehler in Zinnector® 0.1.0 und 0.1.1. Unter Windows führte das Installationsprogramm der Runtime npm.cmd namentlich aus, und Node verweigert seit dem Fix für CVE-2024-27980 das Starten einer .cmd-Datei ohne Shell – daher stürzte die Installation eine Sekunde, nachdem Sie mit Y geantwortet hatten, ab. Behoben in 0.1.2: npm wird nun als node npm-cli.js ausgeführt, was auf jeder Plattform identisch ist und keine Shell benötigt. Führen Sie npm install -g zinnector@latest aus, danach erneut zinnector dev.
Ihre Node-Version ist älter als 24. npm gibt die Warnung aus, da das Paket engines: >=24.18.1 deklariert; die Installation wird dennoch abgeschlossen, aber zinnector verweigert anschließend den Start (Exit-Code 78), anstatt später an einer unübersichtlichen Stelle fehlzuschlagen. Installieren Sie die aktuelle LTS-Version von nodejs.org – winget install OpenJS.NodeJS.LTS unter Windows, brew install node@24 unter macOS –, vergewissern Sie sich, dass node --version den Wert v24 oder höher ausgibt, und installieren Sie Zinnector® erneut.
Die WordPress-Runtime enthält ein natives Modul, dessen vorkompilierte Binärdateien nur für Node 24 und 25 existieren. Auf einer neueren Node-Version (26 und höher, Stand September 2026) weicht das Installationsprogramm auf die Kompilierung aus dem Quellcode aus, was auf einem einfachen Windows-System mit der Aufforderung zur Installation von Visual Studio endet. Behoben in 0.1.2: Zinnector® erkennt dies vor dem Herunterladen und ruft ein Node 24 ausschließlich für die Runtime ab – etwa 30 MB, verifiziert anhand der Prüfsummen von nodejs.org –, sodass niemals etwas kompiliert wird. Falls dieser Fehler nach dem Upgrade weiterhin auftritt, führen Sie zinnector dev --reset-runtime aus, damit die zuvor unvollständige Installation zuerst verworfen wird.
Fast immer hält ein Virenscanner oder ein Suchindexierungsdienst eine Datei unterhalb des node_modules-Ordners der Runtime geöffnet, während npm versucht, diese zu entfernen. Die Installation wird beim nächsten zinnector dev aus einem bereinigten Verzeichnis heraus wiederholt; falls das Problem weiterhin besteht, entfernt zinnector dev --reset-runtime zuerst das gesamte Runtime-Verzeichnis und installiert es erneut.
Die Meldung enthält die letzten Zeilen von npm selbst sowie den exakten Befehl, den Zinnector® ausgeführt hat, sodass Sie ihn selbst ausführen und die vollständige Ausgabe einsehen können. Die üblichen Ursachen sind ein Netzwerk- oder Proxy-Problem – die Runtime wird mit Ihrem eigenen npm abgerufen, weshalb npm config set proxy … und ein Registry-Mirror greifen – oder eine unvollständige vorherige Installation, die mittels --reset-runtime bereinigt wird.
Führen Sie zinnector dev --verbose aus, um die eigene Ausgabe der Runtime anzuzeigen. Ein bereits belegter Port ist die häufigste Ursache: zinnector dev --port 9401 oder legen Sie port in der Datei zinnector.json fest. Eine Runtime, die installiert wurde, aber nicht startet: zinnector dev --reset-runtime. Beim ersten Start wird zudem WordPress selbst heruntergeladen; geben Sie dem Vorgang bei einer langsamen Verbindung daher einige Minuten Zeit; die CLI wartet bis zu fünf Minuten, bevor sie einen Timeout meldet, anstatt hängenzubleiben.
Bereitstellungen werden aus einem Repository heraus gesteuert, weshalb zinnector push ein solches mit einem für die Plattform erreichbaren Remote benötigt. Führen Sie git init && git add -A && git commit -m initial aus, fügen Sie Ihr GitHub- oder GitLab-Remote hinzu und führen Sie anschließend zinnector link aus, um es mit der Site zu verknüpfen.
Führen Sie zinnector check aus. In neun von zehn Fällen liegt ein Versionsunterschied bei PHP vor – Sie haben mit einer neueren PHP-Version entwickelt, als auf dem Slot ausgeführt wird – und der Bericht gibt an, auf welche Version der Slot mittels zinnector php <version> umgestellt werden sollte oder für welche Version Sie die Entwicklung mittels zinnector dev --php <version> anpassen sollten. zinnector logs --error zeigt den eigentlichen schwerwiegenden Fehler an.
Was wir über Hosting, SEO und den Betrieb von Websites in großem Umfang geschrieben haben.
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.
Beitrag lesen →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.
Beitrag lesen →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.
Beitrag lesen →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 →