Kaufen

Sites

Free & Premium

Auf der Seite Sites verwaltest du deine lokalen Websites. Jede Site verbindet einen Ordner auf deinem Mac mit einer eigenen Domain, einem Webserver und auf Wunsch mit einer festen PHP- und Node-Version und HTTPS. Der Front-Proxy von WebDonkey lauscht auf den Ports 80 und 443 und reicht jede Anfrage an die richtige Site weiter. Deshalb öffnest du eine Site unter https://meinprojekt.test und nicht unter localhost:8080.

Was du hier machst

Aufbau der Seite

  • Kopf: der Titel, eine kurze Beschreibung und der Knopf Neue Site. Denselben Knopf findest du auf jeder Seite in der oberen Leiste.
  • Reiter: WebDonkey, Pages, DDEV und Docker. Hinter jedem Reiter steht die Zahl seiner Einträge, auch wenn sie 0 ist. WebDonkey merkt sich den gewählten Reiter, bis du die App beendest.
    • WebDonkey: deine eigenen Sites.
    • Pages: Sites, die WebDonkey Pages eingerichtet hat, und gebaute Pages-Websites, die hier noch keine Site haben.
    • DDEV: die Projekte deiner DDEV-Installation.
    • Docker: Container, Images, Volumes, Netzwerke und Compose-Projekte deines Docker-Daemons.
  • Liste: in den Reitern WebDonkey und Pages eine Tabelle mit einer Zeile je Site, darüber die Zahlen Gesamt, Aktiv und SSL. Hat der Reiter WebDonkey noch keine Site, steht dort „Noch keine Sites. Lege deine erste an.“ mit dem Knopf Neue Site.

Solange das Formular zum Anlegen oder Bearbeiten offen ist, sind Reiter und Liste ausgeblendet. Zurück zu den Sites, Abbrechen oder die Esc-Taste bringen sie zurück.

Free und Premium

Sites, der Reiter Pages, DDEV und Docker sind in Free enthalten. In Free nutzen höchstens drei Sites gleichzeitig HTTPS. Premium hebt diese Grenze auf und schaltet die Site-Pakete frei. Mehr dazu unter SSL-Zertifikate und Site-Pakete. Preise findest du auf webdonkey.io/pricing.

Der Reiter WebDonkey Free & Premium

Der Reiter WebDonkey zeigt alle Sites, die WebDonkey für dich betreibt, mit Ausnahme der Websites aus WebDonkey Pages. Hier schaltest du Sites ein und aus, öffnest sie im Browser, im Finder, im Terminal oder im Editor und erreichst alle weiteren Aktionen einer Site.

So findest du es

Seitenleiste Lokal › Sites, Reiter WebDonkey. Im Terminal listet wd sites deine Sites, siehe Grundbefehle.

Die Liste

Über der Tabelle stehen drei Zahlen: Gesamt (alle Sites des Reiters), Aktiv (eingeschaltet) und SSL (mit HTTPS).

Spalte Inhalt
Site Die Domain, darunter der Document Root. Ein grünes Schloss zeigt HTTPS an, +2 die Zahl der Aliase. Fährst du mit der Maus über die Domain, siehst du alle Aliase. Eine eben angelegte Site trägt Neu, bis du die Seite verlässt.
Server Der Webserver der Site: nginx, Caddy oder Apache. Bei einer Site mit Serve-Kommando steht hier Prozess mit dem Port und einem Punkt, der grün ist, solange der Prozess läuft.
Laufzeit PHP- und Node-Version der Site, jede mit einem farbigen Punkt für ihren Versionsstatus. Ein Strich heißt: statische Site ohne PHP und Node. In schmalen Fenstern steht die Laufzeit unter dem Server.
Status Ein Schalter mit Aktiv oder Aus. Gibt es den Ordner der Site nicht mehr, steht hier Ordner fehlt statt des Schalters.

Aktionen einer Site

Rechts in jeder Zeile stehen dieselben Knöpfe an denselben Plätzen:

  • Im Browser öffnen: startet, was die Site braucht, und öffnet ihre Domain. Was dabei passiert, steht weiter unten.
  • Im Finder öffnen: öffnet den Projektordner der Site immer im Finder, unabhängig von den Einstellungen. Hat die Site keinen eigenen Projektordner, ist es der Document Root.
  • Terminal im Ordner öffnen: eine Shell im Projektordner. Wo sie aufgeht, legst du unter Öffnen mit fest.
  • Im Editor öffnen: öffnet den Projektordner im Code-Editor. Mit der Einstellung Automatisch ist das der WebDonkey Editor, sobald er installiert ist, sonst die App unter Code öffnen in.
  • Bearbeiten (Stift): öffnet das Formular mit allen Werten der Site, siehe Site anlegen und bearbeiten.
  • Weitere Aktionen (…): das Menü mit den selteneren Aktionen.

In schmalen Fenstern wandern Im Finder öffnen, Terminal im Ordner öffnen und Im Editor öffnen in das Menü Weitere Aktionen.

Das Menü Weitere Aktionen

  • Bei einer Site mit Serve-Kommando stehen oben Prozess neu starten und Prozess stoppen. Steht der Prozess und ist die Site eingeschaltet, steht dort Prozess starten. Siehe Sites mit Serve-Kommando.
  • Diagnose ausführen: prüft die Kette vom Browser bis zur Datei, siehe Site-Diagnose.
  • Cert + vhost neu generieren: schreibt die Webserver-Konfiguration der Site neu, stellt bei HTTPS ihr Zertifikat neu aus und lädt Webserver und Front-Proxy neu. Das hilft, wenn eine Konfigurationsdatei von Hand verändert wurde.
  • Site entfernen: öffnet die Rückfrage zum Entfernen, siehe Site entfernen.

So gehst du vor

Eine Site ausschalten

  1. Klick in der Zeile der Site auf den Schalter in der Spalte Status.
  2. Die Spalte zeigt Aus, die Domain ist freigegeben.

Zum Einschalten klickst du den Schalter erneut. WebDonkey schreibt dann die Konfiguration wieder und startet, was die Site braucht.

Eine Site im Browser öffnen

  1. Klick in der Zeile auf Im Browser öffnen.
  2. WebDonkey startet die nötigen Dienste und öffnet die Domain in deinem Standardbrowser, mit https://, wenn die Site SSL hat, sonst mit http://.

Was im Hintergrund passiert

Ausschalten entfernt die Webserver-Konfiguration der Site, gibt ihre Domain frei und gleicht die Einträge in /etc/hosts ab. Deine Dateien bleiben, wie sie sind.

Im Browser öffnen geht so vor:

  1. PHP-FPM in der Version der Site starten, falls sie PHP nutzt, und ihren Webserver, falls er noch nicht läuft.
  2. Von den Datenbank-Servern nur die starten, auf die die Konfiguration der Site zeigt, etwa ihre .env oder wp-config.php. Nennt die Konfiguration gar keine Datenbank, startet WebDonkey alle in WebDonkey installierten Datenbank-Server. Hält ein fremdes Programm den Port eines Datenbank-Servers, lässt WebDonkey ihn aus.
  3. Die Konfiguration der Site neu schreiben und dafür sorgen, dass der Front-Proxy die Ports 80 und 443 bedient.
  4. Die Domain im Browser öffnen.

Bei einer Site mit Serve-Kommando startet WebDonkey statt PHP und Webserver ihren Prozess. Ändern sich Domain, Aliase oder SSL einer Site, passt WebDonkey Webserver-Konfiguration, Zertifikat und Namensauflösung beim Speichern selbst an.

Free und Premium

In Free haben höchstens drei Sites gleichzeitig SSL. Der Rest der Liste und alle Aktionen sind in Free enthalten. Siehe SSL-Zertifikate.

Wenn es nicht klappt

Was du siehst Warum Was du tust
Meldung „Site konnte nicht gestartet werden“ Der Webserver der Site oder ihre PHP-Version fehlt oder startet nicht. Die Meldung nennt den Webserver. Unter Services Webserver und PHP installieren oder starten, dann noch einmal öffnen. Hilft das nicht, die Site-Diagnose laufen lassen.
Meldung, die Port 80/443-Weiterleitung konnte nicht aktiviert werden Der Front-Proxy bedient die Ports 80 und 443 nicht. Ohne ihn sind Sites nur mit Port erreichbar. Den Grund unter der Meldung lesen. In der Diagnose zeigt die Zeile zum Front-Proxy, ob er läuft.
Ordner fehlt in der Spalte Status Der Document Root wurde gelöscht oder verschoben. Schalter und Ordner-Knöpfe sind deshalb gesperrt. Unter Bearbeiten einen anderen Ordner wählen oder die Site entfernen.
Meldung „Die Site ist angelegt, aber ihre Dienste ließen sich nicht starten.“ Beim Anlegen startete ein Dienst nicht. Die Site bleibt deshalb vorerst aus. Den Grund in der Meldung beheben und die Site einschalten.
Statt der Liste steht Fehler mit Erneut versuchen Die Liste der Sites ließ sich nicht lesen. Erneut versuchen klicken.

Siehe auch

Site anlegen und bearbeiten Free

Eine Site verbindet einen Ordner auf deinem Mac mit einer Domain, einem Webserver und auf Wunsch mit PHP, Node und HTTPS. Mit Neue Site legst du eine an, mit Bearbeiten änderst du sie später. Beides geschieht im selben Formular, das die Seite Sites ganz ausfüllt.

So findest du es

  • Seite Sites: Neue Site oben rechts. Ist noch keine Site da, steht der Knopf auch mitten in der leeren Liste.
  • Jede Seite: Neue Site in der oberen Leiste.
  • Eine bestehende Site: Bearbeiten (Stift) in ihrer Zeile.
  • Im Terminal legt wd sites create <domain> eine Site für den aktuellen Ordner an, siehe Grundbefehle.

So gehst du vor

  1. Klick auf Neue Site.
  2. Lass unter Site-Paket (optional) die Kachel Ohne Paket gewählt oder wähl ein Paket, siehe Site-Pakete.
  3. Trag unter Adresse einen Name und eine Domain ein, zum Beispiel meinprojekt.test.
  4. Wähl unter Ordner & Auslieferung den Document Root, entweder als Pfad oder über Auswählen.
  5. Wähl unter Server & Laufzeit den Webserver und bei Bedarf PHP-Version (optional) und Node-Version (optional).
  6. Lass SSL via lokaler WebDonkey-CA eingeschaltet, wenn die Site unter https:// laufen soll.
  7. Klick unten auf Anlegen.

Das Formular schließt sich, der Reiter WebDonkey zeigt die neue Site mit dem Zeichen Neu.

Vier Angaben braucht jede Site: Name, Domain, Document Root und Webserver. Fehlt eine davon, trägt ihr Feld einen Punkt an der Beschriftung und einen farbigen Rahmen, unten steht „Noch nötig: …“, und Anlegen bleibt gesperrt.

Eine Site bearbeiten

  1. Klick in der Zeile der Site auf Bearbeiten.
  2. Das Formular heißt jetzt Site bearbeiten und zeigt darunter die Domain. Den Abschnitt Site-Paket gibt es beim Bearbeiten nicht.
  3. Ändere, was du brauchst, auch Webserver, PHP-Version oder Domain.
  4. Klick auf Speichern.

WebDonkey schreibt die Konfiguration des Webservers neu. Eine geänderte Domain bekommt ein neues Zertifikat und neue Einträge für die Namensauflösung.

Das Formular schließen

Zurück zu den Sites, Schließen (Esc), Abbrechen und die Esc-Taste schließen das Formular. Hast du schon etwas eingetragen, fragt WebDonkey „Eingaben verwerfen?“. Weiter bearbeiten lässt alles stehen, Verwerfen wirft die Eingaben weg. Während ein Site-Paket installiert, lässt sich das Formular nicht schließen.

Wechselst du mit offenem Formular auf eine andere Seite, etwa um unter Services eine Datenbank zu starten, bleibt das halb ausgefüllte Formular erhalten. Kommst du ins Fenster zurück, prüft das Formular erneut, welche Webserver, PHP- und Node-Versionen installiert sind. So siehst du auch, was du inzwischen im Terminal nachinstalliert hast.

Felder und Optionen

Site-Paket (optional)

Nur beim Anlegen. Die Kachel Ohne Paket legt eine leere Site für ein Projekt an, das du selbst mitbringst. Die übrigen Kacheln installieren eine Anwendung gleich mit. Ein gewähltes Paket entscheidet, welche Laufzeit-Felder weiter unten erscheinen und welche Versionen dort passen. Site-Pakete sind Premium, Einzelheiten unter Site-Pakete.

Adresse

Feld Bedeutung
Name Der Anzeigename in WebDonkey. Pflicht.
Domain Pflicht. Erlaubt sind Buchstaben, Ziffern und Bindestriche, mit mindestens einem Punkt und einer Endung, etwa shop.dev oder kunde.local. Die Endung ist frei wählbar. Passt die Schreibweise nicht, steht darunter „Buchstaben, Ziffern und Bindestriche, mit Endung, z. B. meinprojekt.test“.
Aliases (optional, Komma-getrennt) Weitere Domains für dieselbe Site, getrennt durch Komma oder Leerzeichen. Sie stehen mit im Zertifikat.

Eine reine Endung wie test nimmt WebDonkey nicht als Domain an, weil er sonst jede Adresse darunter auf deinen Mac umleiten würde. Nimm einen Namen davor, etwa meinprojekt.test.

Ordner & Auslieferung

Feld Bedeutung
Document Root Der Ordner, den der Webserver ausliefert. Pflicht. Auswählen öffnet die Ordnerauswahl, ~/ am Anfang ist erlaubt. Ein Framework-Paket stellt ihn nach der Installation selbst auf das richtige Unterverzeichnis, etwa public/.
Projektordner Optional: wo der Code liegt, wenn nicht im Document Root, zum Beispiel der Ordner über public/. Die Knöpfe für Ordner, Terminal und Editor öffnen ihn. Geplante Aufgaben, Workflows, der Arbeitsordner der KI und die Suche nach der Datenbank einer Site nehmen ihn ebenfalls. Leer gilt der Document Root.
Serve-Kommando Leer für eine gewöhnliche Site. Ausgefüllt, etwa mit npm start, bedient dieser Prozess die Site statt eines Document Roots. Das erste Feld heißt dann Projektordner, das zweite Projektordner-Feld fällt weg, und Port erscheint. Siehe Sites mit Serve-Kommando.
Port Nur mit Serve-Kommando. Leer bleibt automatisch, dann wählt WebDonkey einen freien Port.

Server & Laufzeit

Feld Bedeutung
Webserver Pflicht. Die Liste zeigt die installierten Webserver mit Version und Herkunft, vorausgewählt ist der erste. Je Site wählbar, unabhängig von den anderen Sites. Ist keiner installiert, steht dort „(keiner installiert)“ mit einem Hinweis auf die Seite Services.
PHP-Version (optional) Die Site läuft mit genau dieser installierten PHP-Version. (keine) steht für eine Site ohne PHP. Unter dem Feld steht der Versionsstatus der gewählten Version, in der Liste bekommen andere Versionen die Zusätze EOL oder Empfohlen. Darunter folgt der Hinweis zum Datenbank-Host (siehe unten).
Node-Version (optional) Eine von WebDonkey installierte Node-Version oder (keine). Braucht ein Paket Node und gibt es auf dem Mac ein Node außerhalb von WebDonkey, steht zusätzlich Node des Systems (…) zur Wahl.
SSL via lokaler WebDonkey-CA Stellt ein Zertifikat der lokalen Zertifizierungsstelle aus und schaltet HTTPS frei. Bei einer neuen Site ist das Häkchen in Premium gesetzt, in Free nicht. In Free steht daneben, wie viele Sites SSL nutzen, etwa „2/3 Seiten mit SSL“.

Mit einem Site-Paket heißen die Laufzeit-Felder zum Beispiel „PHP-Version (Shopware 6 braucht …)“. Versionen, die nicht passen, sind ausgegraut und tragen den Zusatz „passt nicht zu …“. Nutzt das Paket eine Laufzeit gar nicht, fehlt ihr Feld.

Einstellungen des Pakets

Hast du ein Paket gewählt, folgt der Abschnitt Einstellungen für … mit den Feldern des Pakets, siehe Site-Pakete.

Tipp: Datenbank-Host im Code

Trägst du im Code einer Site einen Datenbank-Host ein, nimm 127.0.0.1 mit Port 3306 (MySQL) oder 3307 (MariaDB), nicht localhost. Mit localhost sucht PHP eine Socket-Datei, die die Datenbank-Server von WebDonkey nicht verwenden.

Was im Hintergrund passiert

Beim Anlegen schreibt WebDonkey die Konfiguration für den gewählten Webserver und den Front-Proxy, stellt bei SSL das Zertifikat aus und trägt die Domain samt Aliasen für die Namensauflösung ein. Danach startet er, was die Site braucht. Lässt sich ein Dienst nicht starten, bleibt die Site ausgeschaltet, und eine Meldung nennt den Grund.

Ist unter Einstellungen Tools im Terminal eingeschaltet, nutzen php und node im Projektordner einer Site und seinen Unterordnern die Versionen dieser Site.

Free und Premium

  • Site-Pakete sind Premium. In Free ist der Abschnitt Site-Paket gesperrt und trägt das Premium-Zeichen.
  • In Free haben höchstens drei Sites gleichzeitig SSL. Ist die Grenze erreicht, ist das Häkchen SSL via lokaler WebDonkey-CA gesperrt und trägt das Premium-Zeichen. Premium hebt die Grenze auf.

Wenn es nicht klappt

Was du siehst Warum Was du tust
Hinweis unter dem Feld Domain Die Schreibweise passt nicht: Leerzeichen, Sonderzeichen, kein Punkt oder ein Bindestrich am Rand eines Teils. Nur Buchstaben, Ziffern und Bindestriche verwenden, mit Endung.
Meldung, die Domain sei eine ganze Endung Du hast eine Endung wie dev oder co.uk als Domain eingetragen. Einen Namen davor setzen, etwa meinprojekt.dev.
„(keiner installiert)“ beim Webserver Es ist noch kein Webserver installiert. Unter Services nginx, Caddy oder Apache installieren. Das Formular bleibt offen.
Das Häkchen SSL ist gesperrt In Free haben schon drei Sites SSL. Bei einer anderen Site SSL ausschalten oder Premium nutzen.
Fehlermeldung unter dem Formular Das Anlegen ist gescheitert, etwa weil eine andere Site die Domain schon nutzt. Die Meldung lesen und die Angabe ändern.

Siehe auch

Site-Pakete Premium

Ein Site-Paket installiert beim Anlegen einer Site gleich eine ganze Anwendung: Shopware, WordPress, ein Framework oder ein Frontend-Gerüst, samt Datenbank, Konfiguration und richtigem Document Root. Du wählst es im Formular Neue Site unter Site-Paket (optional). Site-Pakete sind eine Premium-Funktion.

So findest du es

Seite Sites › Neue Site, erster Abschnitt Site-Paket (optional). Beim Bearbeiten einer bestehenden Site gibt es den Abschnitt nicht. Im Terminal installiert wd sites create <domain> --package <paket> ein Paket, wd sites packages listet alle.

So gehst du vor

  1. Klick auf Neue Site und wähl unter Site-Paket (optional) eine Kachel, etwa Shopware 6.
  2. Prüf unter Benötigt, ob alles da ist. Fehlendes installierst du mit Jetzt installieren oder Einrichten.
  3. Füll Adresse, Ordner & Auslieferung und Server & Laufzeit aus wie bei jeder Site, siehe Site anlegen und bearbeiten. Wähl als Document Root am besten einen leeren Ordner.
  4. Prüf die Felder unter Einstellungen für …, zum Beispiel Datenbank-Name und Admin-Passwort.
  5. Klick auf Anlegen. WebDonkey prüft zuerst Ordner und Datenbank („Prüfe Ordner und Datenbank…“).
  6. Die Installation läuft. Ein Kasten zeigt „Paket wird installiert …“, den Schritt („Schritt 3 / 9“) und die Ausgabe live.
  7. Ist sie durch, klick auf Fertig. Die neue Site steht in der Liste.

Die Pakete

Paket Was WebDonkey installiert Document Root
Statische Website (HTML) eine index.html mit dem Seitentitel der gewählte Ordner
PHP (leeres Projekt) eine index.php, auf Wunsch mit einer MySQL- oder MariaDB-Datenbank (Datenbank anlegen) der gewählte Ordner
WordPress Datenbank, WP-CLI (gegen seine Prüfsumme geprüft), WordPress, wp-config.php, Installation mit Admin-Benutzer, Theme Twenty Twenty-Four der gewählte Ordner
Shopware 6 Datenbank, composer create-project shopware/production, .env.local mit Datenbank, APP_URL und Mailpit als Mailer, system:install mit Sprache, Währung und Shop-Name, Admin-Passwort für den Benutzer admin, auf Wunsch Demo-Daten und das kompilierte Storefront-Theme public/
Laravel composer create-project laravel/laravel, .env mit Datenbank und Mailpit, APP_KEY, Migration, Storage-Link public/
Symfony Skeleton plus Webapp-Pack, .env.local mit APP_SECRET, DATABASE_URL und Mailpit als Mailer public/
Drupal Datenbank, drupal/recommended-project, Drush, site:install mit dem gewählten Profil, Einstellungen für den Front-Proxy web/
Vite (React / Vue / Vanilla) Gerüst mit der gewählten Vorlage, npm install, Build dist/
Astro (statisch) Gerüst mit der gewählten Vorlage, npm install, Build dist/
Angular neues Projekt mit Angular CLI, Build dist/app/browser/
Hugo minimales Layout mit zwei Inhaltsseiten, Build mit hugo --minify public/

Bei Vite, Astro und Angular liefert der Webserver das gebaute Ergebnis aus, es läuft kein Node-Server. Wird der Document Root auf ein Unterverzeichnis gesetzt, wird der bisherige Ordner zum Projektordner der Site.

Felder und Optionen

Benötigt

Was ein Paket braucht, steht fest und erscheint sofort nach der Wahl. Jede Zeile nennt ihren Zustand:

Zeile Mögliche Zustände
Datenbank Auswahl der Engine (MySQL oder MariaDB) und ihrer Version. „läuft“, „gestoppt, wird beim Anlegen gestartet“ oder „Nicht installiert.“ mit Jetzt installieren. Dazu Host und Port, etwa „Host 127.0.0.1, Port 3306“.
PHP ob eine installierte Version in den Bereich des Pakets fällt. Sonst etwa „Installiert ist 8.1.31, das passt nicht zu Shopware 6 (braucht …).“
PHP-Erweiterungen „Alle 23 in PHP 8.4 geladen“ oder welche fehlen. Kann WebDonkey eine Erweiterung selbst laden, steht Einrichten daneben.
memory_limit der Wert der gewählten PHP-Version. Ist er zu niedrig, ändert Einrichten die php.ini von WebDonkey für diese Version und startet sie neu, falls sie läuft.
Node.js ob eine installierte Version passt, sonst Jetzt installieren.
Werkzeuge etwa Composer oder Hugo, mit Jetzt installieren.

Steht noch etwas aus, ist Anlegen gesperrt, und unten steht zum Beispiel „Shopware 6 braucht noch: PHP-Erweiterungen (oben installieren).“ Während WebDonkey die Voraussetzungen noch prüft („Wird geprüft …“), bleibt Anlegen ebenfalls gesperrt.

Einstellungen für …

Die Felder des Pakets mit sinnvollen Vorgaben. Der Datenbank-Name folgt der Domain, bis du ihn selbst änderst, damit zwei Shops nicht dieselbe Datenbank bekommen. Passwortfelder zeigst du mit Anzeigen und verbirgst sie mit Verbergen. Versionsfelder wie Shopware-Version (live von Packagist) laden die Versionen beim Öffnen („Lade Versionen…“). Unter Andere … trägst du einen eigenen Wert ein.

Paket Felder
Shopware 6 Shop-Name, Unterordner im DocRoot (optional), Shopware-Version (live von Packagist), Datenbank-Name, Datenbank-User, Datenbank-Passwort, Standard-Währung (EUR, USD, GBP, CHF), Sprache / Locale, Admin-Passwort, Demo-Daten installieren, Storefront-Theme kompilieren
WordPress Seitentitel, Admin-Benutzername, Admin-Passwort, Admin-E-Mail, Datenbank-Name, -User und -Passwort
Drupal Seitenname, Admin-Benutzername, Admin-Passwort, Installationsprofil (Standard oder Minimal), Datenbank-Name, -User und -Passwort
Laravel Laravel-Version (live von Packagist), Datenbank (SQLite ohne Server, MySQL oder MariaDB) und bei MySQL oder MariaDB Name, User und Passwort
Symfony Datenbank (SQLite, MySQL oder MariaDB) mit Name, User und Passwort
PHP (leeres Projekt) Datenbank anlegen, dann Engine, Name, User und Passwort
Vite (React / Vue / Vanilla) Vorlage: React, Vue, Vanilla, Svelte oder Preact, mit oder ohne TypeScript
Astro (statisch) Vorlage: Minimal, Basics oder Blog
Angular Angular-Version, Stylesheets (CSS, SCSS, Sass, Less, Tailwind CSS), Change Detection, Tests, Routing
Statische Website (HTML), Hugo Seitentitel

Die Datenbank-Engine eines Pakets, das zwingend eine Datenbank braucht, wählst du unter Benötigt. Sie erscheint unten nicht noch einmal.

Was im Hintergrund passiert

  • WebDonkey legt zuerst die Site an, dann führt er die Schritte des Pakets nacheinander aus. Das Paket startet gestoppte Dienste, die es braucht, selbst.
  • Die Datenbank wird angelegt, der gewählte Benutzer bekommt die nötigen Rechte.
  • Liegen im Ordner schon Dateien, die das Paket ersetzen würde, nennt WebDonkey sie beim ersten Klick auf Anlegen (bis zu acht, dann „und … weitere“). Eine Kopie legt er nicht an. Wähl einen leeren Ordner oder klick auf Ersetzen und anlegen.
  • Eine Datenbank mit Tabellen überschreibt WebDonkey nie. Er bricht vorher ab und bittet um einen anderen Datenbanknamen.

Free und Premium

Site-Pakete sind Premium. In Free zeigt der Abschnitt das Premium-Zeichen und den Hinweis „Site-Pakete sind eine Premium-Funktion.“, die Kacheln sind gesperrt. Leere Sites ohne Paket legst du in Free uneingeschränkt an. Preise: webdonkey.io/pricing.

Wenn es nicht klappt

Was du siehst Warum Was du tust
„In diesem Ordner liegen schon Dateien, die die Vorlage ersetzen würde:“ Der Ordner ist nicht leer. Einen leeren Ordner wählen oder noch einmal klicken (Ersetzen und anlegen).
„Die Datenbank „…“ ist nicht leer“ Unter dem Namen gibt es schon eine Datenbank mit Tabellen. Einen anderen Datenbank-Namen eintragen.
„Abgebrochen, bevor sich etwas geändert hat“ im Protokoll Beim Start der Installation lagen schon Dateien im Ordner. Einen leeren Ordner wählen.
„Paket wird installiert (Fehler)“ Ein Schritt ist gescheitert. Das Protokoll zeigt seine Ausgabe. Die Ausgabe lesen, die Ursache beheben und das Formular mit Schließen verlassen. Die Site existiert bereits und lässt sich entfernen oder neu aufsetzen.
PHP-Erweiterung „gehört nicht zu diesem Build“ Die gewählte PHP-Version wurde ohne diese Erweiterung gebaut. Eine andere PHP-Version wählen oder die Erweiterung selbst ergänzen, etwa per PECL.

Siehe auch

Sites mit Serve-Kommando Free

Manche Projekte bringen ihren eigenen Server mit, etwa ein Node-Projekt mit npm start oder ein Dev-Server von Next.js oder Vite. Für solche Sites trägst du ein Serve-Kommando ein. Dann bedient dieser langlaufende Prozess die Site statt eines Document Roots, und der Front-Proxy reicht die Anfragen an seinen Port weiter. Die Domain mit HTTPS bleibt dieselbe wie bei jeder anderen Site.

So findest du es

Formular Neue Site oder Bearbeiten, Abschnitt Ordner & Auslieferung, Feld Serve-Kommando. Gesteuert wird der Prozess danach im Reiter WebDonkey über das Menü Weitere Aktionen der Site.

So gehst du vor

  1. Öffne Neue Site und trag Name und Domain ein.
  2. Trag unter Serve-Kommando den Befehl ein, der den Server startet, zum Beispiel npm start.
  3. Das erste Feld heißt jetzt Projektordner. Wähl den Ordner, in dem das Kommando laufen soll, dort, wo die package.json liegt.
  4. Lass Port leer (automatisch) oder trag einen festen Port ein.
  5. Wähl einen Webserver. Das Formular verlangt ihn, die Site nutzt ihn aber nicht.
  6. Klick auf Anlegen. WebDonkey startet den Prozess und wartet, bis er auf seinem Port antwortet.

Felder und Optionen

Feld Bedeutung
Serve-Kommando Leer für eine gewöhnliche Site. Ausgefüllt startet WebDonkey diesen Befehl als Prozess der Site. Leerst du das Feld später, wird die Site wieder eine gewöhnliche Site mit Document Root.
Projektordner Der Ordner, in dem das Kommando läuft. Bei dieser Art Site gibt es kein zweites Projektordner-Feld.
Port Leer wählt WebDonkey einen freien Port zwischen 3000 und 3199 und behält ihn für die Site. Der Prozess bekommt ihn als Umgebungsvariable PORT.

Den Prozess steuern

In der Liste steht in der Spalte Server statt des Webservers Prozess mit dem Port. Der Punkt davor ist grün, solange der Prozess läuft. Fährst du mit der Maus darüber, siehst du Prozess läuft oder Prozess gestoppt und das Kommando.

Im Menü Weitere Aktionen der Site stehen:

  • Prozess neu starten und Prozess stoppen, solange der Prozess läuft.
  • Prozess starten, wenn er steht und die Site eingeschaltet ist.

Ein laufender Prozess erscheint auch im Menü Aktive Dienste in der oberen Leiste und auf der Seite Services unter Außerdem aktiv. Ist der letzte Start gescheitert, steht der Grund in der Zeile unter der Domain.

Was im Hintergrund passiert

  • Der Prozess bekommt die Umgebungsvariablen PORT (sein Port), HOST und HOSTNAME (jeweils 127.0.0.1).
  • WebDonkey startet ihn über denselben Supervisor wie die Dienste. Er läuft in einer eigenen Prozessgruppe, seine Ausgabe landet in einer Log-Datei, und nach einem Absturz der App räumt WebDonkey übrig gebliebene Prozesse beim nächsten Start auf.
  • Nach dem Start wartet WebDonkey bis zu 60 Sekunden, bis der Port antwortet. Erst dann gilt der Start als gelungen, und Im Browser öffnen öffnet die Domain. So landest du während eines langen ersten Builds nicht auf einer Fehlerseite des Proxys.
  • Eine solche Site braucht weder PHP-FPM noch einen Webserver. WebDonkey startet beides für sie nicht.
  • Beim nächsten Start der App startet WebDonkey die Prozesse aller eingeschalteten Sites mit Serve-Kommando wieder, nacheinander.

Free und Premium

Site-Prozesse belegen keinen der sechs Dienst-Plätze von Free. Sites mit Serve-Kommando sind in Free enthalten.

Wenn es nicht klappt

Was du siehst Warum Was du tust
Im WLAN erreichbar (WLAN-Zeichen neben dem Port) Der Server lauscht auf allen Netzwerkschnittstellen statt nur auf 127.0.0.1. Geräte im selben WLAN erreichen ihn direkt über den Port, am Proxy von WebDonkey vorbei. Den Server an 127.0.0.1 binden, etwa mit --host 127.0.0.1 oder indem er HOST bzw. HOSTNAME aus der Umgebung liest, und ihn neu starten.
„Der Prozess von … hat sich beendet.“ Das Kommando ist gleich nach dem Start abgebrochen. Die Meldung nennt die Log-Datei mit seiner letzten Ausgabe. Das Log lesen. Oft fehlen Abhängigkeiten (npm install) oder der Ordner stimmt nicht.
„… lauscht nach 60 Sekunden nicht auf Port …“ Der Prozess läuft, aber auf einem anderen Port. Das Kommando so einstellen, dass es den Port aus PORT liest, oder den Port im Formular fest eintragen.
Ein Banner meldet, dass die Site nicht starten kann, weil ihr Port belegt ist Ein anderes Programm hält den Port. Port … freiräumen im Banner beendet dieses Programm und startet die Site neu. Oder einen anderen Port eintragen.

Siehe auch

Site-Diagnose Free

Die Site-Diagnose prüft jede Schicht zwischen Browser und Datei und zeigt, wo es hakt. Lädt eine Site nicht, zeigt der Browser eine Zertifikatswarnung oder antwortet eine falsche Seite, findest du damit in Sekunden die Stelle, an der die Kette reißt.

So findest du es

Seite Sites, Zeile der Site › Weitere Aktionen (…) › Diagnose ausführen. Im Terminal prüft wd sites diagnose dieselbe Kette.

So gehst du vor

  1. Öffne in der Zeile der Site das Menü Weitere Aktionen und wähl Diagnose ausführen.
  2. Der Dialog Site-Diagnose („Prüft jede Schicht zwischen Browser und Datei“) zeigt kurz „Prüfe…“ und dann die Ergebnisse.
  3. Jede Zeile trägt einen grünen Haken oder ein rotes Kreuz, darunter bei Bedarf Einzelheiten, etwa einen Pfad oder eine Fehlermeldung.
  4. Behebe die erste rote Zeile und klick auf Erneut prüfen.
  5. Schließen beendet den Dialog.

Was geprüft wird

In dieser Reihenfolge, Zeilen für SSL und nginx nur, wenn sie zur Site passen:

Prüfung Was eine rote Zeile bedeutet
Document Root existiert Den Ordner der Site gibt es nicht.
Index-Datei vorhanden (index.html oder index.php) Im Document Root liegt keine Startdatei. Bei Frameworks zeigt der Document Root oft auf den falschen Ordner.
Eintrag für die Domain in /etc/hosts Die Domain zeigt nicht auf deinen Mac.
Front-Proxy auf 80/443 aktiv Ohne den Proxy erreicht keine Domain ihre Site.
Webserver der Site läuft nginx, Caddy oder Apache ist gestoppt.
PHP-FPM-Socket für die PHP-Version der Site PHP in dieser Version läuft nicht.
Vhost-Datei generiert Die Webserver-Konfiguration der Site fehlt.
SSL-Zertifikat ausgestellt (nur mit SSL) Es gibt kein Zertifikat für die Site.
HTTPS-Port 443 nimmt Verbindungen an (nur mit SSL) Der Proxy nimmt keine HTTPS-Verbindungen an.
nginx -t (nur bei nginx) Die nginx-Konfiguration hat einen Fehler, die Einzelheiten nennen ihn.

Wenn etwas rot ist

Rote Zeile Was du tust
Document Root oder Index-Datei Unter Bearbeiten den richtigen Ordner wählen, bei Frameworks etwa public/.
Webserver oder PHP-FPM Den Dienst unter Services starten oder mit Im Browser öffnen starten lassen.
Vhost-Datei, Zertifikat oder nginx -t Weitere Aktionen › Cert + vhost neu generieren, siehe Der Reiter WebDonkey.
Hosts-Eintrag Die Site mit dem Schalter aus- und wieder einschalten. WebDonkey gleicht /etc/hosts dabei neu ab.
Front-Proxy oder Port 443 Im Menü Aktive Dienste prüfen, ob der Front-Proxy läuft. Scheitert der Start des Front-Proxys, nennt ein Banner oben im Fenster den Grund.
Der Browser warnt trotz grüner Zeilen Der Root-CA wird noch nicht vertraut, siehe Root-CA vertrauen.

Siehe auch

Site entfernen Free

Site entfernen nimmt eine Site aus WebDonkey: Webserver-Konfiguration, SSL-Zertifikat, Hosts- und DNS-Einträge und ihr Runtime-Verzeichnis. Deine Projektdateien bleiben dabei, wo sie sind. Willst du mehr aufräumen, nimmt der Dialog auf Wunsch die verknüpfte Datenbank und den Projektordner mit, den Ordner nur in den Papierkorb.

So findest du es

Seite Sites, Zeile der Site › Weitere Aktionen (…) › Site entfernen. Im Terminal entfernt wd sites delete <site> nur die Konfiguration, nie Datenbank oder Ordner.

So gehst du vor

  1. Öffne in der Zeile der Site das Menü Weitere Aktionen und wähl Site entfernen.
  2. Der Dialog Site entfernen? nennt die Domain und den Projektordner.
  3. Setz bei Bedarf eines oder beide Häkchen (siehe unten). Beide stehen anfangs auf aus.
  4. Klick auf Entfernen.

Die Site verschwindet aus der Liste. Ließ sich etwas von dem, was du angehakt hast, nicht mitnehmen, nennt eine Meldung danach den Grund. Die Site selbst ist dann trotzdem entfernt.

Felder und Optionen

Häkchen Was es tut
Verknüpfte Datenbank … (…) auch löschen Löscht die Datenbank, die die Konfiguration der Site nennt, etwa in .env oder wp-config.php, auf einem Datenbank-Server von WebDonkey (MySQL, MariaDB oder PostgreSQL). Name und Engine stehen in der Beschriftung. Das Häkchen erscheint nur, wenn WebDonkey eine solche Datenbank findet.
Projektdateien in den Papierkorb legen Legt den Projektordner in den Papierkorb, sein Pfad steht darunter. Von dort holst du ihn bei Bedarf zurück. Hat die Site keinen eigenen Projektordner, ist es der Document Root. Mit dem Häkchen ändert sich der Text des Dialogs entsprechend.

Was WebDonkey verweigert

Manches darf nicht mitgehen. Dann ist das Häkchen ausgegraut, und darunter steht der Grund. WebDonkey prüft das beim Klick auf Entfernen noch einmal.

Grund unter dem Häkchen Bedeutung
„Der Datenbank-Server läuft nicht.“ Starte den Server unter Services und öffne den Dialog erneut.
„Diese Datenbank gibt es auf dem Server nicht.“ Die Konfiguration nennt eine Datenbank, die es nicht gibt.
„Sie gehört zum Datenbank-Server selbst.“ Systemdatenbanken wie mysql löscht WebDonkey nie.
„Wird auch von der Site … genutzt.“ Eine andere Site nutzt dieselbe Datenbank oder denselben Ordner.
„Den Ordner gibt es nicht.“ Der Projektordner fehlt bereits.
„Das ist dein Benutzerordner oder ein Ordner darüber.“ Der Ordner ist zu weit oben im Dateisystem.
„Diesen Ordner braucht macOS.“ Systemordner und Ordner wie Schreibtisch, Dokumente oder Downloads selbst. Ein Projekt darin darf gehen.
„Das ist dein Sites-Ordner aus den Einstellungen oder ein Ordner, der ihn enthält.“ Der Ordner, in dem deine Sites liegen, bleibt.
„Der Ordner gehört zu WebDonkey Pages.“ Websites von Pages verwaltet Pages selbst.

Was im Hintergrund passiert

  • WebDonkey entfernt die Webserver-Konfiguration, das Zertifikat der Site, ihre Einträge in /etc/hosts und für den lokalen DNS sowie ihr Runtime-Verzeichnis. Das lässt sich nicht rückgängig machen.
  • Die Datenbank wird nur mit Häkchen gelöscht, endgültig.
  • Der Projektordner geht nur mit Häkchen in den Papierkorb, nie direkt ins Nichts.
  • Entfernst du eine Site, die WebDonkey Pages eingerichtet hat, erscheint ihre Website wieder unter Aus WebDonkey Pages im Reiter Pages.

Wenn es nicht klappt

Was du siehst Warum Was du tust
„Die Site ist entfernt, die Datenbank … ließ sich aber nicht löschen“ Beim Löschen der Datenbank kam ein Fehler, er steht in der Meldung. Die Datenbank unter Datenbanken von Hand löschen.
„Die Site ist entfernt, ihr Projektordner ließ sich aber nicht in den Papierkorb legen“ Der Ordner ist gesperrt oder es fehlen Rechte. Den Ordner im Finder selbst in den Papierkorb legen.
„Die Site ließ sich nicht entfernen“ Das Entfernen ist gescheitert, der Grund steht dabei. Den Grund beheben und es erneut versuchen.

Siehe auch

Der Reiter Pages Free

Der Reiter Pages sammelt die Websites, die du mit WebDonkey Pages baust, als lokale Test-Sites. WebDonkey liefert den gebauten Stand einer Website mit PHP unter einer eigenen Domain aus, so testest du sie samt Kontaktformular auf deinem Mac, bevor sie online geht. Websites, die du in Pages schon gebaut, aber hier noch nicht eingerichtet hast, richtest du mit einem Klick ein.

So findest du es

Seitenleiste Lokal › Sites, Reiter Pages. Die Zahl am Reiter zählt die eingerichteten Sites und die Websites, die noch auf ihre Einrichtung warten. In WebDonkey Pages legt In WebDonkey testen eine solche Site an, siehe In WebDonkey testen.

Was der Reiter zeigt

  • Die Liste: alle Sites, die WebDonkey Pages eingerichtet hat, in derselben Tabelle wie im Reiter WebDonkey. Jede trägt das Kennzeichen Pages („Von WebDonkey Pages eingerichtet“).
  • Aus WebDonkey Pages: darunter die Websites, die in Pages gebaut, hier aber noch nicht eingerichtet sind („In WebDonkey Pages gebaut, hier noch nicht eingerichtet.“). Jede Zeile nennt den Namen der Website und ihre künftige Adresse.
  • Leer: Gibt es beides nicht, steht dort „Noch keine Websites aus WebDonkey Pages. In Pages holst du eine Website mit „In WebDonkey testen“ hierher.“

So gehst du vor

Eine gebaute Website lokal einrichten

  1. Öffne den Reiter Pages.
  2. Such die Website unter Aus WebDonkey Pages.
  3. Klick auf Lokal einrichten. Der Tooltip sagt, was passiert, etwa „Richtet meine-firma.pages mit PHP ein und startet die Site.“
  4. Die Website wandert in die Liste darüber, ist eingeschaltet und läuft. Mit Im Browser öffnen rufst du sie auf.

Zurück nach Pages

  • In der Liste: Weitere Aktionen (…) › In Pages öffnen.
  • Unter Aus WebDonkey Pages: In Pages öffnen in der Zeile der Website.

WebDonkey Pages öffnet sich dann mit dieser Website.

Adresse, Ordner und Laufzeit

Was Wert
Domain Die Adresse, die WebDonkey Pages für die Website festlegt. Ohne eigene Angabe ist es der Kurzname der Website mit der Endung .pages, etwa meine-firma.pages. Ändert Pages die Adresse, zieht die Site mit, samt Zertifikat und Namensauflösung.
Document Root Der gebaute Stand der Website im Ordner .pages/dist.
Projektordner Der Ordner der Website unter ~/WebDonkey Pages/ mit ihrem Code. Ordner-, Terminal- und Editor-Knopf öffnen ihn.
Webserver nginx
PHP die aktive PHP-Version, damit das Kontaktformular der Website funktioniert
SSL an, solange die Grenze von Free es zulässt, sonst ohne

Im Übrigen ist eine Pages-Site eine normale Site: Du schaltest sie ein und aus, bearbeitest sie, lässt die Diagnose laufen und siehst ihre Laufzeit samt Versionsstatus.

Was im Hintergrund passiert

  • WebDonkey liest den Ordner ~/WebDonkey Pages nur. Er schreibt dort nichts hinein.
  • Als „gebaut“ gilt eine Website, deren Ordner eine website.json und einen gebauten Stand mit .pages/dist/index.html hat.
  • Entfernst du eine Pages-Site, bleibt der Ordner der Website stehen. In den Papierkorb legen lässt er sich aus WebDonkey nicht, weil er zu WebDonkey Pages gehört. Die Website erscheint danach wieder unter Aus WebDonkey Pages.

Free und Premium

Der Reiter Pages ist in Free enthalten. In Free bekommt eine neu eingerichtete Pages-Site nur dann SSL, wenn noch nicht drei Sites SSL nutzen.

Wenn es nicht klappt

Was du siehst Warum Was du tust
„WebDonkey Pages ließ sich nicht öffnen. Ist die App auf diesem Mac installiert?“ WebDonkey Pages fehlt auf dem Mac. Pages unter Services in der Gruppe WebDonkey herunterladen, siehe Die WebDonkey-Apps.
Fehler unter einer Website nach Lokal einrichten Die Einrichtung ist gescheitert, etwa weil PHP oder nginx fehlt oder die Adresse schon vergeben ist. Die Meldung lesen, unter Services nachinstallieren und erneut einrichten.
Die Website fehlt unter Aus WebDonkey Pages Sie ist in Pages noch nicht gebaut, oder es gibt schon eine Site für sie. In Pages die Website bauen oder die vorhandene Site in der Liste suchen.

Siehe auch

Der Reiter DDEV Free

DDEV startet PHP-Projekte wie Shopware, Laravel oder WordPress in Docker-Containern. Ist DDEV installiert, erscheinen deine DDEV-Projekte im Reiter DDEV neben den WebDonkey-Sites. Du startest und stoppst sie hier, öffnest sie im Browser oder im Terminal ihres Containers und verwaltest Konfiguration, Snapshots, Logs und Add-ons. Projekte, die du im Terminal mit ddev config anlegst, tauchen von selbst auf.

So findest du es

Seitenleiste Lokal › Sites, Reiter DDEV. Die Zahl am Reiter ist die Zahl der Projekte. Solange der Reiter offen ist, fragt WebDonkey alle sechs Sekunden nach dem Stand, sonst alle 30 Sekunden.

Wenn DDEV fehlt

Ohne DDEV zeigt der Reiter DDEV ist nicht installiert mit einer kurzen Erklärung und drei Knöpfen:

  • Installieren: installiert DDEV über Homebrew. Fehlt Homebrew, richtet WebDonkey es vorher ein. Die laufende Ausgabe steht darunter.
  • Mehr zu DDEV: öffnet ddev.com.
  • Erneut prüfen: sucht noch einmal nach DDEV, etwa nachdem du es im Terminal installiert hast.

DDEV braucht einen Docker-Daemon, etwa Docker Desktop, OrbStack oder Colima. Fehlt das docker-Kommando, steht ein Hinweis darauf schon hier, siehe Der Reiter Docker.

Die Liste

Über der Tabelle stehen „Verwalte deine DDEV-Projekte: Konfiguration, Snapshots, Logs und Add-ons.“, die Zahlen Gesamt und Läuft und der Knopf Neues Projekt.

Spalte Inhalt
Projekt Name und Ordner des Projekts. Ein Klick klappt die Verwaltung darunter auf, siehe DDEV-Projekt verwalten.
Typ Der Projekttyp, etwa shopware6, laravel oder wordpress.
Adresse Die Adresse des Projekts, nur in breiten Fenstern.
Status Ein Schalter zum Starten und Stoppen mit Läuft, Aus oder Pausiert. Zwischenzustände wie starting zeigt WebDonkey so, wie DDEV sie meldet.

Aktionen eines Projekts

  • Im Browser öffnen: öffnet die Adresse des Projekts, solange es läuft.
  • Projektordner anzeigen: öffnet den Ordner. In schmalen Fenstern steht der Knopf im Menü Weitere Aktionen.
  • Terminal im Container öffnen: eine Shell im Web-Container, solange das Projekt läuft. Wo sie aufgeht, legst du unter Öffnen mit fest. Mit WebDonkey (eingebautes Terminal) öffnet sie als Tab auf der Seite SFTP / SSH.
  • Weitere Aktionen (…): Neu starten (nur wenn es läuft) und Löschen.

Löschen fragt nach („DDEV-Projekt entfernen“) und entfernt das Projekt aus DDEV: Container, Volumes und Datenbank werden gelöscht. Der Projektordner bleibt unangetastet.

Neues Projekt

Neues Projekt öffnet den Dialog DDEV-Projekt einrichten. Er macht aus einem vorhandenen Ordner ein DDEV-Projekt.

Feld Bedeutung Vorgabe
Projektordner Der Ordner mit deinem Code, eintippen oder über Auswählen… wählen. Pflicht. leer
Projektname Name in DDEV. Pflicht. Wählst du den Ordner aus, schlägt WebDonkey den Ordnernamen in Kleinbuchstaben vor. Ordnername
Projekttyp Einer der Typen, die DDEV kennt, etwa php, shopware6, laravel, drupal11, typo3, wordpress. php
Dokumentwurzel Der Unterordner, den der Webserver ausliefert, etwa public. leer
PHP-Version 5.6 bis 8.5 8.3
Webserver nginx-fpm, apache-fpm oder generic nginx-fpm
Datenbank mariadb, mysql oder postgres mariadb
Datenbank-Version die Versionen der gewählten Datenbank 10.11
Direkt starten startet das Projekt nach dem Einrichten an

Die PHP- und Datenbank-Versionen tragen in der Auswahl die Zusätze EOL oder Empfohlen aus dem Versionsstatus. Klick auf Neues Projekt, um anzulegen.

Was im Hintergrund passiert

  • WebDonkey steuert DDEV über dessen eigenes Kommando ddev. Die Projekte bleiben ganz normale DDEV-Projekte, die du genauso im Terminal bedienen kannst.
  • Läuft gerade keine Docker-Engine, zeigt der Reiter eine Zeile dazu. Ist eine Engine installiert, startet … starten sie im Hintergrund, ohne dass sich ein Fenster öffnet. Wacht Docker Desktop gerade aus dem Ressourcensparmodus auf, erscheinen die Projekte von selbst, sobald die Engine antwortet.
  • Die Adressen von DDEV-Projekten trägt WebDonkey bei Bedarf selbst in /etc/hosts ein. Dafür fragt macOS einmalig nach deinem Administrator-Passwort.

Free und Premium

Der Reiter DDEV ist ganz in Free enthalten. DDEV-Projekte zählen nicht zu den sechs Diensten von Free.

Wenn es nicht klappt

Was du siehst Warum Was du tust
Ordner gelöscht oder Konfiguration fehlt statt des Schalters DDEV führt das Projekt noch, aber sein Ordner oder seine .ddev/config.yaml ist weg. Starten geht nicht mehr. Im Menü Weitere Aktionen das Projekt aus DDEV löschen.
Meldung, die Adressen ließen sich nicht auflösen Viele Router blockieren DNS-Antworten, die auf den eigenen Mac zeigen. Das Projekt erneut starten und die Passwortabfrage von macOS bestätigen. WebDonkey trägt die Adressen dann in /etc/hosts ein.
Meldung, DDEV brauche ein neueres docker-buildx Docker Desktop bringt eine zu alte Fassung mit, und das Nachrüsten ist gescheitert. Internetverbindung prüfen und erneut starten oder Docker Desktop aktualisieren.
„DDEV meldet: …“ mit Hinweis auf die Docker-Laufzeit Deine Docker-Laufzeit ist älter, als DDEV es künftig verlangt. Die Projekte starten noch. Docker Desktop oder deine Docker-Laufzeit bald aktualisieren.
Schalter lässt sich nicht einschalten Kein Docker-Daemon läuft. Die Engine über die Zeile oben starten oder sie selbst starten und Erneut prüfen.

Siehe auch

DDEV-Projekt verwalten Free

Ein Klick auf den Namen eines DDEV-Projekts klappt seine Verwaltung direkt unter der Zeile auf. Sie hat fünf Reiter: Konfiguration, Snapshots, Logs, Add-ons und Befehl. Damit änderst du die config.yaml des Projekts, sicherst und tauschst seine Datenbank, liest seine Logs, ergänzt Dienste wie Redis und führst Befehle im Container aus.

So findest du es

Seite Sites, Reiter DDEV, Klick auf den Namen eines Projekts. Ein zweiter Klick klappt die Verwaltung wieder zu. WebDonkey merkt sich das offene Projekt und den gewählten Reiter, bis du die App beendest. Projekte, deren Ordner fehlt, lassen sich nicht aufklappen.

Konfiguration

Das Formular bearbeitet die config.yaml des Projekts. Über dem Formular steht ihr Pfad.

Feld Bedeutung
Projekttyp Der Typ, nach dem DDEV das Projekt einrichtet.
Dokumentwurzel Der Ordner, den der Webserver ausliefert.
PHP-Version 5.6 bis 8.5. Die Auswahl zeigt EOL oder Empfohlen, unter dem Feld steht der Versionsstatus der gewählten Linie.
Webserver nginx-fpm, apache-fpm oder generic.
Datenbank mariadb, mysql oder postgres. Wechselst du die Datenbank, springt die Version auf die neueste der neuen Datenbank.
Datenbank-Version Die Versionen der gewählten Datenbank, mit Versionsstatus.
Composer-Version etwa 2.
Node.js-Version etwa 22, mit Versionsstatus.
Zusätzliche Hostnamen weitere Hostnamen des Projekts, durch Komma getrennt, etwa staging, preview.
Zusätzliche Domains weitere vollständige Domains, durch Komma getrennt, etwa example.test.
Xdebug aktivieren schaltet Xdebug für das Projekt ein.

Als YAML bearbeiten wechselt zum Rohtext der Datei, Zurück zum Formular wieder zurück.

  1. Ändere die Werte und klick auf Speichern.
  2. WebDonkey meldet „Gespeichert. Starte das Projekt neu, damit die Änderungen greifen.“
  3. Klick auf Neu starten.

Formular und YAML sind zwei getrennte Fassungen. Gespeichert wird nur die Ansicht, in der du gerade bist. Wechselst du mit ungespeicherten Änderungen, fragt WebDonkey „Ungespeicherte Änderungen verwerfen?“ und wechselt erst nach Trotzdem wechseln. Die vorherige Fassung der Datei bleibt als config.yaml.wd-backup erhalten. Ändert sich die Datei außerhalb von WebDonkey, zeigt das Formular nach dem nächsten Laden den neuen Stand.

Snapshots

Snapshots sichern die Datenbank des Projekts. Beim Wiederherstellen wird die aktuelle Datenbank ersetzt.

  • Snapshot anlegen: sichert die Datenbank jetzt. Im Feld davor vergibst du auf Wunsch einen Namen („Name (optional)“).
  • Wiederherstellen: ersetzt nach einer Rückfrage die aktuelle Datenbank durch den Stand des Snapshots.
  • Papierkorb: löscht einen Snapshot nach einer Rückfrage endgültig.
  • Datenbank exportieren: speichert die Datenbank in eine Datei, vorgeschlagen ist <projekt>.sql.gz.
  • Datenbank importieren: ersetzt die Datenbank durch den Inhalt einer Datei (.sql, .gz, .zip oder .tar). WebDonkey fragt vorher „Datenbank importieren?“.

Jeder Snapshot zeigt Datum und Größe. Ohne Snapshots steht dort „Noch keine Snapshots.“

Vor jedem Import legt WebDonkey einen Snapshot der jetzigen Datenbank an. Danach meldet er „Importiert. Die vorherige Datenbank liegt als Snapshot „…“ bereit.“, und du holst den alten Stand bei Bedarf mit Wiederherstellen zurück. Scheitert dieser Snapshot, importiert WebDonkey nicht.

Logs

Zeigt die letzten Zeilen der Ausgabe eines Dienstes des Projekts und lädt sie alle fünf Sekunden neu.

  • Erste Auswahl: der Dienst, etwa web, db oder ein Dienst aus einem Add-on.
  • Zweite Auswahl: 50, 200, 500 oder 1000 Zeilen, vorgegeben sind 200.
  • Aktualisieren lädt sofort neu.

Gibt es nichts, steht dort „Keine Log-Ausgabe.“

Add-ons

Add-ons fügen dem Projekt zusätzliche Dienste hinzu, etwa Redis oder Elasticsearch.

  • Die Liste zeigt die installierten Add-ons mit ihrem Repository. Der Papierkorb (Add-on entfernen) nimmt ein Add-on samt Dienst nach einer Rückfrage wieder heraus.
  • Im Feld Name oder owner/repo trägst du ein Add-on ein und klickst auf Installieren.
  • Darunter stehen die offiziellen Add-ons, die noch fehlen, als Schnellknöpfe, etwa + redis, + memcached, + elasticsearch, + solr, + mongo, + varnish, + adminer, + phpmyadmin, + cron, + beanstalkd und + proxy-support.

Befehl

Führt einen Befehl im Web-Container des Projekts aus, etwa composer install. Trag ihn ein und klick auf Ausführen oder drück die Eingabetaste. Die Ausgabe erscheint darunter, ohne Ausgabe steht „(keine Ausgabe)“. Für längere Arbeit im Container öffnest du besser Terminal im Container öffnen in der Zeile des Projekts.

Wenn es nicht klappt

Was du siehst Warum Was du tust
Rote Meldung im Reiter DDEV hat den Befehl abgelehnt, die Meldung zeigt seine Ausgabe. Die Ausgabe lesen, oft fehlt ein laufender Docker-Daemon.
„Die Datenbank wurde nicht importiert: WebDonkey konnte vorher keinen Snapshot der jetzigen Datenbank anlegen.“ Die Sicherung vor dem Import ist gescheitert. Prüfen, ob das Projekt läuft, und erneut importieren.
Änderungen der Konfiguration wirken nicht Das Projekt läuft noch mit der alten Fassung. Neu starten.

Siehe auch

Der Reiter Docker Free

Der Reiter Docker zeigt, was dein Docker-Daemon gerade enthält: Container, Images, Volumes, Netzwerke und Compose-Projekte. Du startest und stoppst Container, öffnest sie im Browser oder im Terminal, liest ihre Logs und räumst Ungenutztes auf. WebDonkey benutzt dafür das docker-Kommando, egal welche App den Daemon bereitstellt: Docker Desktop, OrbStack, Colima und Rancher Desktop werden erkannt.

So findest du es

Seitenleiste Lokal › Sites, Reiter Docker. Die Zahl am Reiter ist die Zahl der Container.

Wenn Docker fehlt oder schläft

  • Docker ist nicht installiert: Der Reiter erklärt, wofür er da ist, und bietet Docker Desktop herunterladen (öffnet die Seite von Docker) und Erneut prüfen. Nach der Installation startest du Docker einmal und klickst auf Erneut prüfen.
  • Colima ohne docker-Kommando: Colima bringt das Kommando nicht mit. Dann steht dort Docker-CLI installieren, das es über Homebrew nachinstalliert.
  • OrbStack ohne docker-Kommando: Starte OrbStack einmal, dann richtet es das Kommando selbst ein.
  • Keine Engine läuft: Eine Zeile sagt „Gerade läuft keine Docker-Engine.“, und je installierter Engine gibt es einen Knopf … starten. Die Engine startet im Hintergrund, ohne dass sich ein Fenster öffnet. Die Container erscheinen, sobald sie bereit ist.
  • Docker wacht auf: Kommt Docker Desktop gerade aus dem Ressourcensparmodus, steht das in der Zeile. Du musst nichts tun.

Aufbau des Reiters

Oben wählst du zwischen Container, Images, Volumes, Netzwerke und Compose, jeweils mit ihrer Zahl. Daneben steht, wie viel Platz sich freigeben lässt (Freigebbar: …), und ein Knopf zum Aktualisieren. Die Ressourcen lädt WebDonkey alle 15 Sekunden neu. Images, Volumes, Netzwerke und Compose beschreibt Container starten und Docker-Ressourcen.

Container

Über der Tabelle stehen Gesamt, Läuft und der Knopf Container starten.

Spalte Inhalt
Container Name, darunter Image und Status, wie Docker ihn meldet. Ein Klick klappt Details und Logs auf, siehe Container-Details und Logs.
Ports Die veröffentlichten Ports. Ein Klick auf einen Port öffnet http://localhost:<port>.
Status Ein Schalter zum Starten und Stoppen mit Läuft, Aus oder Pausiert.

Aktionen in jeder Zeile:

  • Im Browser öffnen: öffnet den Web-Port des Containers, solange er läuft.
  • Terminal im Container öffnen: eine Shell im Container, solange er läuft. Wo sie aufgeht, legst du unter Öffnen mit fest.
  • Weitere Aktionen (…): Neu starten, Pausieren oder Fortsetzen und Löschen.

Löschen fragt nach („Container löschen“). Ein laufender Container wird zuerst gestoppt, das Image bleibt erhalten.

So gehst du vor

Einen Container stoppen und wieder starten

  1. Klick in der Zeile des Containers auf den Schalter in der Spalte Status.
  2. Der Container stoppt, der Schalter zeigt Aus.
  3. Ein zweiter Klick startet ihn wieder.

Einen neuen Container starten

Klick auf Container starten und füll den Dialog aus, siehe Container starten und Docker-Ressourcen.

Free und Premium

Der Reiter Docker ist ganz in Free enthalten. Container zählen nicht zu den sechs Diensten von Free.

Wenn es nicht klappt

Was du siehst Warum Was du tust
„Keine Docker-Container gefunden.“ Der Daemon läuft, hat aber keine Container. Einen Container mit Container starten anlegen.
„Keine Docker-Engine gefunden. Im Tab Docker kannst du eine einrichten.“ Es ist keine Engine installiert. Docker Desktop, OrbStack oder Colima installieren.
„Starten fehlgeschlagen: …“ Die Engine ließ sich nicht starten. Die Engine selbst öffnen und danach Erneut prüfen.
Rote Meldung über der Liste Docker hat eine Aktion abgelehnt. Die Meldung lesen, sie ist die Antwort von Docker.

Siehe auch

Container-Details und Logs Free

Ein Klick auf einen Container im Reiter Docker klappt seine Details direkt unter der Zeile auf. Du siehst, wie er gestartet wurde, wie stark er den Mac gerade belastet, welche Ports, Netzwerke, Mounts und Umgebungsvariablen er hat, und liest seine Ausgabe.

So findest du es

Seite Sites, Reiter Docker, Unterreiter Container, Klick auf den Namen eines Containers. Ein zweiter Klick klappt die Details wieder zu. Oben in den Details wählst du zwischen Details und Logs. WebDonkey merkt sich die Wahl, bis du die App beendest.

Details

Zeile Inhalt
ID Die ID des Containers.
Image Das Image, aus dem er läuft.
Erstellt Wann der Container angelegt wurde.
Neustart-Regel Wie Docker ihn nach einem Ende neu startet, etwa no oder unless-stopped.
Befehl Der Befehl, mit dem der Container läuft.
Auslastung CPU, Arbeitsspeicher (RAM), Netzwerk (NET) und Datenträger (IO).
Ports Die Port-Zuordnungen.
Netzwerke Die Netzwerke, an denen er hängt.
Mounts Eingebundene Ordner und Volumes, je eine Zeile.
Umgebung Die Umgebungsvariablen, je eine Zeile.

Zeilen ohne Inhalt fallen weg. Die Angaben aktualisieren sich alle zehn Sekunden von selbst.

Logs

Zeigt die letzten Zeilen der Ausgabe des Containers und lädt sie alle fünf Sekunden neu. Oben wählst du 50, 200, 500 oder 1000 Zeilen, vorgegeben sind 200. Beim ersten Laden steht dort kurz der Ladehinweis, ohne Ausgabe „Keine Log-Ausgabe.“

Wenn es nicht klappt

Was du siehst Warum Was du tust
Rote Meldung statt der Details Docker konnte den Container nicht beschreiben, etwa weil er gerade gelöscht wurde. Die Liste aktualisieren.
Keine Auslastung Der Container läuft nicht. Ihn über den Schalter starten.

Siehe auch

Container starten und Docker-Ressourcen Free

Neben den Containern verwaltest du im Reiter Docker alles, woraus Docker Container baut und womit sie arbeiten: Images, Volumes, Netzwerke und Compose-Projekte. Hier startest du auch einen neuen Container aus einem Image und räumst auf, was keiner mehr braucht.

So findest du es

Seite Sites, Reiter Docker. Container starten steht im Unterreiter Container, die Ressourcen haben eigene Unterreiter: Images, Volumes, Netzwerke und Compose.

Container starten

Container starten öffnet einen Dialog („Startet einen neuen Container aus einem Image.“):

Feld Bedeutung
Image Pflicht, etwa nginx:alpine. Fehlt das Image lokal, holt Docker es.
Name (optional) Der Name des Containers. Leer vergibt Docker einen.
Ports (eine pro Zeile, host:container) etwa 8080:80. Ein so veröffentlichter Port ist nur auf diesem Mac erreichbar (127.0.0.1). Soll ein Port ins Netz, schreib die Adresse davor: 0.0.0.0:8080:80.
Umgebungsvariablen (eine pro Zeile, KEY=wert) etwa KEY=value. Eine Zeile je Variable, damit Werte mit Komma heil bleiben.
Volumes (eines pro Zeile, quelle:/ziel) etwa /host/path:/container/path.
Neustart-Regel no (Vorgabe), always, unless-stopped oder on-failure.

Klick auf Container starten. Der Dialog schließt sich, der Container erscheint in der Liste.

Images

Über der Tabelle stehen Gesamt und In Benutzung, ein Eingabefeld mit Laden und der Knopf Aufräumen.

  • Laden holt das eingetragene Image, etwa nginx:alpine.
  • Die Spalten: Image (Name und Tag), Größe, Erstellt und Status. Der Status zeigt in Benutzung, wenn ein Container das Image nutzt, und ungenutzt für Images ohne Namen und Tag.
  • Der Papierkorb löscht ein Image nach einer Rückfrage. Bereits laufende Container arbeiten weiter. Bei Images in Benutzung ist der Papierkorb gesperrt.
  • Aufräumen löscht alle ungenutzten Images. Images, die ein Container benutzt, bleiben erhalten.

Volumes

Volumes halten die Daten der Container. Über der Tabelle stehen Gesamt, In Benutzung und Aufräumen.

  • Die Spalten: Volume (Name und Pfad), Treiber, Größe (wenn Docker sie kennt) und Benutzt von mit den Namen der Container.
  • Der Papierkorb löscht ein Volume samt allen Daten darin, nach einer Rückfrage. Das lässt sich nicht rückgängig machen. Ein Volume in Benutzung lässt sich nicht löschen.
  • Aufräumen löscht alle Volumes, die kein Container benutzt, samt der Daten darin.

Netzwerke

Netzwerke verbinden Container miteinander. Über der Tabelle stehen Gesamt, In Benutzung und Aufräumen.

  • Die Spalten: Netzwerk, Treiber und Container.
  • Die eingebauten Netzwerke von Docker tragen eingebaut und lassen sich nicht löschen.
  • Der Papierkorb löscht ein eigenes Netzwerk, solange kein Container daran hängt.
  • Aufräumen löscht alle Netzwerke, an denen kein Container hängt.

Compose

Zeigt die Compose-Projekte auf diesem Rechner, darüber Gesamt und Läuft.

  • Die Spalten: Projekt (Name und Compose-Datei), Container (etwa „2 von 3 laufen“) und Status.
  • Der Schalter Status startet ein Projekt (up) oder stoppt seine Container.
  • Datei anzeigen öffnet die Compose-Datei des Projekts in einem Dialog.
  • Weitere Aktionen (…): Neu starten und Herunterfahren. Herunterfahren stoppt das Projekt nach einer Rückfrage und entfernt Container und Netzwerke. Benannte Volumes bleiben erhalten.

Aufräumen und Freigebbar

Oben im Reiter steht, wie viel Platz sich freigeben lässt (Freigebbar: …). Vor jedem Aufräumen fragt WebDonkey nach und sagt, was gelöscht wird. Danach steht die Antwort von Docker über der Liste.

Was im Hintergrund passiert

WebDonkey ruft für jede Aktion das docker-Kommando auf, etwa docker image prune -f beim Aufräumen der Images. Für Images wird dabei nie --all verwendet, so bleiben Images mit Namen erhalten, auch wenn gerade kein Container sie nutzt.

Wenn es nicht klappt

Was du siehst Warum Was du tust
Rote Meldung nach Laden Docker kennt das Image nicht oder es gibt kein Netz. Name und Tag prüfen, etwa nginx:alpine.
Papierkorb gesperrt Das Image, Volume oder Netzwerk wird noch benutzt. Zuerst den Container löschen, der es nutzt.
Ein Port des neuen Containers ist von einem anderen Gerät nicht erreichbar Ports ohne Adresse bindet WebDonkey an 127.0.0.1. 0.0.0.0: vor den Port schreiben.

Siehe auch

Cookie-Voreinstellungen

Diese Website verwendet Cookies, um eine bestmögliche Erfahrung bieten zu können. Deine Wahl gilt für webdonkey.io und den Shop unter shop.webdonkey.io. Mehr Informationen ...

Technisch erforderlich

Für die Funktion der Website erforderliche Cookies:

Immer an
WebDonkey
WebDonkey
Anbieter: BuI Hinsche GmbH, Neumarkt 7, 06712 Zeitz
Zweck: Deine Einwilligung, Farbschema und Sprache für Website und Shop, Preisschalter; mit wd_debug in der Adresse die Messereignisse in der Entwicklerkonsole zur Fehlersuche
Cookies und Speicher: Cookie wd_consent auf .webdonkey.io, gemeinsam mit shop.webdonkey.io (12 Monate); Cookies wd_theme und wd_lang auf .webdonkey.io, gemeinsam mit shop.webdonkey.io, nur wenn du Farbschema oder Sprache selbst umschaltest (365 Tage); localStorage wd:consent, wd:theme, wd:lang; sessionStorage wd:acc, wd:term, wd:debug (nur mit wd_debug in der Adresse; bis der Tab schließt)

Statistik

Zeigt uns, welche Seiten und Produkte auf webdonkey.io und im Shop angesehen werden, woher Besucher kommen und wie sie bis zum Kauf gelangen (mit Bestellnummer, Betrag und Produkten, ohne Name und E-Mail-Adresse). Anbieter: Google. Übermittlung in die USA möglich (EU-US Data Privacy Framework). Deine Wahl gilt für webdonkey.io und den Shop gemeinsam.

Google Tag Manager, Google Analytics 4
Google Tag Manager
Anbieter: Google Ireland Limited, Gordon House, Barrow Street, Dublin 4, Irland
Zweck: Lädt die Dienste, denen du zugestimmt hast, hier und im Shop. Setzt selbst keine Cookies.
Cookies und Speicher: keine
Datenschutzerklärung
Google Analytics 4
Anbieter: Google Ireland Limited, Gordon House, Barrow Street, Dublin 4, Irland
Zweck: Nutzungsstatistik: Seitenaufrufe, Klicks, Scrolltiefe, Quellen, Geräte, Ladezeiten; im Shop auch Warenkorb, Kasse, Käufe, Registrierung und Anmeldung
Cookies und Speicher: _ga, _ga_<ID> (2 Jahre)
Datenschutzerklärung

Marketing

Misst, ob unsere Anzeigen auf Facebook, Instagram und TikTok zu Besuchen und Downloads auf webdonkey.io sowie zu Registrierungen und Käufen im Shop führen, und bildet Zielgruppen für Anzeigen. Anbieter: Meta und TikTok, mit denen wir dafür gemeinsam verantwortlich sind. Mit dieser Zustimmung kann auch Google Werbe-Cookies (_gcl_…) setzen. Übermittlung in die USA und weitere Länder außerhalb der EU möglich. Deine Wahl gilt für webdonkey.io und den Shop gemeinsam.

Google Tag Manager, Meta Pixel (Facebook, Instagram), TikTok Pixel
Google Tag Manager
Anbieter: Google Ireland Limited, Gordon House, Barrow Street, Dublin 4, Irland
Zweck: Lädt die Dienste, denen du zugestimmt hast, hier und im Shop. Setzt selbst keine Cookies.
Cookies und Speicher: keine
Datenschutzerklärung
Meta Pixel (Facebook, Instagram)
Anbieter: Meta Platforms Ireland Limited, Merrion Road, Dublin 4, D04 X2K5, Irland
Zweck: Anzeigenmessung und Zielgruppen auf Facebook und Instagram, auch im Shop (Warenkorb, Kasse, Käufe, Registrierung)
Cookies und Speicher: _fbp (3 Monate), _fbc (3 Monate, nur wenn du über eine Anzeige kommst), fr auf facebook.com (3 Monate)
Datenschutzerklärung
TikTok Pixel
Anbieter: TikTok Technology Limited, 10 Earlsfort Terrace, Dublin, D02 T380, Irland
Zweck: Anzeigenmessung und Zielgruppen auf TikTok, auch im Shop (Warenkorb, Kasse, Käufe, Registrierung)
Cookies und Speicher: _ttp, _tt_enable_cookie (13 Monate)
Datenschutzerklärung