Erste Schritte
FreeWebDonkey ist eine lokale Entwicklungsumgebung für den Mac: Webserver, PHP, Node.js, Datenbanken, ein Postfach für Testmails, HTTPS mit eigener Zertifizierungsstelle und viele Werkzeuge in einer App. Alles, was WebDonkey installiert und verwaltet, liegt in einem eigenen Datenordner, der Sandbox (~/Library/Application Support/WebDonkey). Dieses Kapitel bringt dich von der Installation bis zur ersten Site, die im Browser läuft.
Was du hier machst
- Installieren: die App laden, in den Programme-Ordner legen und starten.
- Einrichtung beim ersten Start: fünf kurze Schritte, damit Domains ohne Port und HTTPS ohne Warnung funktionieren.
- Die erste Site: Name, Domain und Ordner eintragen, Anlegen klicken, im Browser öffnen.
- Die ersten Schritte danach: Orientierung im Fenster, Suche mit ⌘K, Dashboard und Benachrichtigungen.
Aufbau
Die Erste-Schritte-Seiten sind keine eigene Seite in der App. Sie führen durch den Einrichtungsdialog und die Seite Sites. Wie das Fenster aufgebaut ist, steht im Kapitel Fenster und Navigation. Die schnellste Bedienung zeigt Suche und Befehle.
Free und Premium
Alles in diesem Kapitel geht mit Free. Free hat Grenzen, etwa höchstens drei Sites gleichzeitig mit SSL und höchstens sechs laufende Dienste. Site-Pakete (zum Beispiel WordPress oder Shopware beim Anlegen gleich mitinstallieren) gehören zu Premium. Was genau wohin gehört, steht unter Free und Premium.
Installieren Free
WebDonkey läuft auf dem Mac ab macOS 11. Du lädst die App als Disk-Image (DMG) herunter, legst sie in den Programme-Ordner und startest sie. Beim ersten Start führt dich ein kurzer Dialog durch die Einrichtung.
So gehst du vor
- Lade WebDonkey von der Download-Seite herunter: shop.webdonkey.io/download.
- Öffne das DMG und ziehe WebDonkey in den Ordner Programme.
- Starte WebDonkey aus dem Programme-Ordner, nicht direkt aus dem DMG.
- Das Fenster öffnet sich mit dem Dialog Willkommen bei WebDonkey. Wie es dort weitergeht, steht unter Einrichtung beim ersten Start.
Die Sprache der Oberfläche wählt WebDonkey beim ersten Start nach der Sprache deines Macs, sonst Englisch. Umstellen kannst du sie jederzeit unter Einstellungen › Allgemein.
Was im Hintergrund passiert
- Ein Datenordner für alles. Installierte Versionen, Konfigurationen, Datenbanken, Logs und Zertifikate liegen unter
~/Library/Application Support/WebDonkey. Den Pfad und die Größe siehst du unter Einstellungen › System. - Wenige, markierte Einträge außerhalb. Damit Domains und HTTPS funktionieren, schreibt WebDonkey Einträge in
/etc/hosts, DNS-Dateien für deine Domains, das Zertifikat seiner Zertifizierungsstelle in deinen Schlüsselbund und einen markierten Block in~/.zshrc. Die vollständige Liste zeigt WebDonkey von diesem Mac entfernen. - Homebrew für Pakete. PHP, Datenbanken und Webserver installiert WebDonkey bei Bedarf über Homebrew. Fehlt Homebrew, richtet der Einrichtungsdialog es ein.
- Die Kommandozeile
wd. Bei jedem Start legt WebDonkey die mitgelieferte Kommandozeilewdin den Ordner, den es für Tools im Terminal in deinen Shell-PATH einträgt. In einem neuen Terminal kannst du sie benutzen, siehe CLI (wd). - Netz. Die App arbeitet lokal. Ins Internet geht sie für Downloads von Paketen, die Update-Prüfung, die Lizenz und Inhalte wie den Changelog. Ohne Verbindung läuft die App weiter, nur diese Abrufe warten.
Updates
Neue Versionen findet WebDonkey selbst und fragt dich, bevor es installiert. Die laufende Version steht oben in der Seitenleiste, ein Klick darauf öffnet den Changelog. Wie die Update-Prüfung arbeitet, steht unter Updates.
Wenn es nicht klappt
| Was du siehst | Warum | Was du tust |
|---|---|---|
wd wird im Terminal nicht gefunden |
Das Terminal war schon offen, oder Tools im Terminal ist aus | Öffne ein neues Terminal und prüfe Einstellungen › Sites & Dienste |
| Der Einrichtungsdialog ist weg, Schritte sind aber offen | Du hast ihn mit Später erledigen geschlossen | Er kommt beim nächsten Start wieder, oder du holst die Schritte in den Einstellungen nach, siehe Einrichtung beim ersten Start |
Siehe auch
Einrichtung beim ersten Start Free
Beim ersten Start öffnet WebDonkey den Dialog Willkommen bei WebDonkey. Er richtet in fünf Schritten ein, was eine lokale Entwicklungsumgebung auf dem Mac braucht: Homebrew und nginx, Einträge in der Hosts-Datei, den Front-Proxy auf den Ports 80 und 443 und das Vertrauen in die eigene Zertifizierungsstelle. Der fünfte Schritt ist freiwillig. Jeden Schritt kannst du später in den Einstellungen nachholen.
So findest du es
Der Dialog erscheint von selbst, solange die Einrichtung nicht abgeschlossen ist. Schließt du ihn mit Später erledigen, mit Esc oder dem Kreuz, kommt er beim nächsten Start wieder.
So gehst du vor
- Oben stehen die fünf Schritte als Kacheln. Ein erledigter Schritt trägt einen Haken.
- Lies den Text des aktuellen Schritts und klicke auf seine Schaltfläche (mit dem Schloss-Symbol).
- Fragt macOS nach deinem Passwort oder einer Bestätigung, bestätige. Solange gewartet wird, steht auf der Schaltfläche Wartet auf Bestätigung….
- Ist der Schritt erledigt, steht dort Bereits aktiv.
- Mit Weiter gehst du zum nächsten Schritt, mit Zurück zum vorigen.
- Im letzten Schritt schließt Fertig die Einrichtung ab. Sind Pflichtschritte offen, heißt die Schaltfläche Trotzdem beenden.
Nach Fertig oder Trotzdem beenden erscheint der Dialog nicht mehr.
Die fünf Schritte
| Schritt | Schaltfläche | Was er tut |
|---|---|---|
| Homebrew & nginx installieren | Homebrew & nginx installieren | Installiert Homebrew mit dem offiziellen Setup und danach nginx. Homebrew braucht WebDonkey, um PHP, Datenbanken und Webserver nachzuinstallieren, nginx liefert deine Sites aus. Ist beides da, ist nichts zu tun. macOS fragt einmal nach deinem Passwort. Den Fortschritt siehst du live in einem Protokollfenster. |
| /etc/hosts beschreiben dürfen | Hosts-Datei freigeben | Trägt die Domains deiner Sites in /etc/hosts ein, damit zum Beispiel meinprojekt.local auf deinen Mac (127.0.0.1) zeigt. WebDonkey ändert nur seine eigenen, markierten Zeilen. Kann die App die Datei nicht direkt schreiben, fragt macOS nach dem Administrator-Passwort. |
| Front-Proxy auf Port 80 / 443 starten | Portmap aktivieren | Startet den Front-Proxy, der die Ports 80 und 443 belegt. Dann öffnest du Sites ohne Port in der Adresse. Er läuft mit deinem Benutzerkonto, ein Admin-Passwort ist nicht nötig. |
| Der lokalen Root-CA vertrauen | CA installieren | Legt eine eigene Zertifizierungsstelle (CA) an und trägt sie in den Anmeldeschlüsselbund deines Benutzers ein. Dann laufen https://-Adressen deiner Sites ohne Browser-Warnung. Entfernen kannst du sie jederzeit in der Schlüsselbundverwaltung. |
| Auch ohne die App nach Zeitplan laufen (freiwillig) | Einrichten | Lässt macOS geplante Aufgaben und Backups selbst ausführen, auch wenn WebDonkey geschlossen ist oder niemand angemeldet ist. macOS fragt einmal nach dem Administrator-Passwort. |
Zum letzten Schritt zeigt der Dialog einen Hinweis: Die Läufe nutzen dein Benutzerkonto, und für Ordner wie Dokumente, Schreibtisch, iCloud Drive oder externe Laufwerke braucht der WebDonkey-Runner einmalig Festplattenvollzugriff in den Systemeinstellungen von macOS.
Wenn nginx Homebrew-Pakete aktualisieren müsste
Würde die Installation von nginx bereits installierte Homebrew-Pakete auf eine neuere Version heben, listet der Schritt sie vorher auf (alte und neue Version). Die Schaltfläche heißt dann Aktualisieren und installieren und ist deine Zustimmung.
Wenn die Ports 80 und 443 belegt sind
Belegt ein anderes Programm die Ports, nennt der Schritt das Programm und bietet Ports 80/443 freiräumen an. Ein Klick beendet dieses Programm und startet den Front-Proxy. Ist es der Router von DDEV, heißt die Schaltfläche DDEV-Router verlegen: WebDonkey legt ihn auf andere Ports (zum Beispiel 9080/9443), laufende DDEV-Projekte starten kurz neu und bleiben erreichbar.
Was im Hintergrund passiert
- Homebrew und nginx landen dort, wo Homebrew sie üblicherweise installiert, nicht in der Sandbox.
- Die Hosts-Einträge tragen eine Markierung von WebDonkey. Fremde Zeilen bleiben unberührt.
- Die CA liegt in der Sandbox, vertraut wird ihr im Anmeldeschlüsselbund.
- Für die Zeitplanung legt WebDonkey je geplanter Aufgabe und je Backup-Set einen Eintrag bei macOS an.
Nachholen in den Einstellungen
| Schritt | Wo du ihn nachholst |
|---|---|
| Homebrew & nginx | über die Seite Services |
| Hosts-Datei | Einstellungen › Sites & Dienste › Hosts-Datei |
| Front-Proxy | Einstellungen › Sites & Dienste › Port-Weiterleitung 80 / 443 |
| Root-CA | Einstellungen › Sites & Dienste › Lokale SSL-Root-CA |
| Zeitplanung | Einstellungen › System › Auch ohne die App nach Zeitplan laufen |
Ohne diese Schritte laufen Sites trotzdem, aber mit Port in der Adresse oder mit Zertifikatswarnung im Browser.
Wenn es nicht klappt
| Was du siehst | Warum | Was du tust |
|---|---|---|
| Dieser Schritt hat nicht geklappt. mit aufklappbaren Einzelheiten | Ein Befehl ist fehlgeschlagen, die Meldung steht in den Einzelheiten | Lies den Grund, behebe ihn und klicke auf Erneut versuchen |
| Die Schaltfläche bleibt nach dem Passwortfenster unverändert | Du hast das Passwortfenster von macOS abgebrochen | Es ist nichts passiert. Klicke noch einmal und bestätige |
| Der Front-Proxy startet nicht | Ein anderes Programm hält Port 80 oder 443 | Ports 80/443 freiräumen oder DDEV-Router verlegen |
Siehe auch
Die erste Site Free
Eine Site ist ein lokales Projekt mit eigener Domain: Ein Webserver liefert einen Ordner auf deinem Mac aus, wahlweise mit PHP oder Node.js und mit HTTPS. Für die erste Site brauchst du einen Projektordner (oder einen leeren Ordner), einen installierten Webserver und eine Domain, die du dir ausdenkst.
So findest du es
- Oben im Fenster auf Neue Site klicken, oder
- in der Seitenleiste Sites öffnen und dort eine neue Site anlegen, oder
- mit ⌘K die Aktion Neue Site suchen.
Es öffnet sich die Ansicht Neue Site mit nummerierten Abschnitten.
So gehst du vor
- Unter Site-Paket (optional) bleibt Ohne Paket gewählt, wenn du ein eigenes Projekt mitbringst.
- Unter Adresse trägst du einen Name ein (frei wählbar, etwa „Mein Projekt“) und eine Domain, zum Beispiel
meinprojekt.local. Die Endung darfst du frei wählen, nötig sind Buchstaben, Ziffern oder Bindestriche und eine Endung. - Unter Ordner & Auslieferung wählst du mit Auswählen den Document Root: den Ordner, den der Webserver ausliefert, oft
public/in deinem Projekt. Ein Pfad mit~wird als vollständiger Pfad gespeichert. - Unter Server & Laufzeit wählst du den Webserver und bei Bedarf eine PHP-Version (optional) oder Node-Version (optional).
- Lass SSL via lokaler WebDonkey-CA an, wenn die Site über
https://laufen soll (in Free ist es zunächst aus, siehe unten). - Klicke unten auf Anlegen.
WebDonkey legt die Site an und startet gleich, was sie braucht: PHP-FPM, den Webserver und, falls nötig, Datenbanken. Danach steht sie in der Liste der Sites und lässt sich im Browser öffnen.
Was noch fehlt, ist an den Feldern markiert und steht neben dem Knopf als Noch nötig: mit den Feldnamen. Anlegen bleibt aus, bis Name, Domain, Document Root und Webserver da sind.
Felder und Optionen
| Feld | Bedeutung |
|---|---|
| Site-Paket (optional) | Installiert beim Anlegen ein Projekt mit, etwa WordPress, Shopware oder Laravel. Premium. Ohne Paket legt eine leere Site für dein eigenes Projekt an. |
| Name | Anzeigename in WebDonkey. |
| Domain | Die Adresse im Browser, zum Beispiel meinprojekt.local. |
| Aliases (optional, Komma-getrennt) | Weitere Domains für dieselbe Site, etwa www.meinprojekt.local. |
| Document Root | Der Ordner, den der Webserver ausliefert. |
| Projektordner | Optional: wo der Code liegt, wenn nicht im Document Root. Ordner, Terminal und Code-Editor öffnen ihn. |
| Serve-Kommando | Leer lassen für eine gewöhnliche Site. Ausgefüllt (zum Beispiel npm start) bedient dieser Prozess die Site statt eines Document Roots. Dann erscheint zusätzlich das Feld Port. |
| Webserver | Ein installierter Webserver mit Version und Herkunft. |
| PHP-Version (optional) | Die PHP-Version dieser Site, (keine) für reine HTML-Sites. |
| Node-Version (optional) | Eine in WebDonkey installierte Node-Version. |
| SSL via lokaler WebDonkey-CA | Stellt der Site ein Zertifikat der lokalen CA aus. Ohne Browser-Warnung läuft es, sobald dein Mac der CA vertraut. |
Unter der PHP-Version steht ein Hinweis zum Datenbank-Host: Im Code deiner Site trägst du 127.0.0.1 mit Port 3306 (MySQL) oder 3307 (MariaDB) ein, nicht localhost.
Alles zu den Feldern, den Site-Paketen und dem Bearbeiten einer Site steht unter Site anlegen und bearbeiten.
Was im Hintergrund passiert
- WebDonkey schreibt die Konfiguration des Webservers (vhost) und, mit SSL, das Zertifikat in die Sandbox.
- Die Domain kommt in
/etc/hostsund in die lokale Namensauflösung. Beim allerersten Mal fragt macOS dafür einmal nach dem Administrator-Passwort, danach nicht mehr. - Die Dienste der Site starten sofort. Ließen sie sich nicht starten, bleibt die Site angelegt, aber ausgeschaltet, und WebDonkey nennt den Grund.
Free und Premium
- In Free haben höchstens drei Sites gleichzeitig SSL. Neben dem SSL-Kästchen zählt WebDonkey mit (zum Beispiel „1/3 Seiten mit SSL“). Haben schon drei andere Sites SSL, ist das Kästchen gesperrt.
- In Free ist SSL bei einer neuen Site zunächst aus, mit Premium an.
- Site-Pakete sind Premium.
Wenn es nicht klappt
| Was du siehst | Warum | Was du tust |
|---|---|---|
| (keiner installiert) beim Webserver | Es ist noch kein Webserver installiert | Installiere unter Services nginx oder Caddy |
| Buchstaben, Ziffern und Bindestriche, mit Endung, z. B. meinprojekt.test unter der Domain | Die Domain hat keine Endung oder ungültige Zeichen | Gib eine Domain mit Endung ein, etwa meinprojekt.local |
| Meldung, dass die Site angelegt ist, ihre Dienste aber nicht starten | Ein Dienst fehlt oder ein Port ist belegt | Lies den Grund, behebe ihn und schalte die Site in der Liste ein oder nutze Im Browser öffnen |
| Der Browser warnt vor dem Zertifikat | Dein Mac vertraut der lokalen CA noch nicht | CA vertrauen unter Einstellungen › Sites & Dienste |
| Die Adresse braucht einen Port | Der Front-Proxy läuft nicht | Aktivieren unter Port-Weiterleitung 80 / 443, siehe Sites & Dienste |
Schließt du das Formular mit Eingaben (✕, Esc, Abbrechen oder Zurück zu den Sites), fragt WebDonkey Eingaben verwerfen?. Weiter bearbeiten bringt dich zurück, Verwerfen schließt.
Siehe auch
Die ersten Schritte danach Free
Die erste Site läuft, die Einrichtung ist durch. Diese Seite zeigt dir in ein paar Minuten, wo du was findest und welche Handgriffe du jeden Tag brauchst.
Dienste starten und stoppen
Oben im Fenster liegt die obere Leiste. Links stehen Alle starten, Alle stoppen und Neustart für alle Dienste auf einmal, daneben Neue Site. Rechts zeigt die Statusanzeige, wie viele Dienste laufen, zum Beispiel „5/8 Dienste aktiv“. Ein Klick darauf öffnet Aktive Dienste: Dort stoppst oder startest du einen einzelnen Dienst neu, ohne die Seite zu wechseln.
Sich zurechtfinden
- Die Seitenleiste ordnet alle Seiten danach, wo die Arbeit stattfindet: Lokal (auf diesem Mac), Remote (auf deinen Servern), Monitoring, Werkzeuge und Konto & Hilfe.
- Mit ⌘K öffnest du von überall Suche und Befehle. Dort findest du Seiten, Sites, Dienste, Einstellungen und Aktionen in einer Liste. Tippe, was du tun willst, etwa „zertifikat“ oder „php“.
- Das Dashboard zeigt den Zustand von Diensten, Sites und mehr auf einen Blick. Du kannst es dir zusammenstellen.
- Die Glocke oben in der Seitenleiste sammelt, was fertig geworden ist: Installationen, Backups, Downloads, Prüfungen.
Ein paar Dinge zum Ausprobieren
- Site im Browser öffnen: über die Zeile der Site unter Sites oder mit ⌘K und der Domain der Site.
- Code öffnen: an der Site Im Editor öffnen. Welcher Editor aufgeht, legst du unter Öffnen mit fest.
- Mails testen: WebDonkey fängt Mails deiner Projekte in einem lokalen Postfach ab. Du siehst sie unter Mail.
- Eine zweite PHP-Version holen: unter Services. Jede Site kann ihre eigene Version haben.
- Das Aussehen wechseln: mit dem Theme-Schalter unten in der Seitenleiste.
- Ein Tastenkürzel anlegen: für eine Aktion, die du oft brauchst, siehe Tastenkürzel.
Wenn etwas nicht stimmt
Unten in der Seitenleiste steht Problem melden. Damit fragst du auf Discord oder meldest einen Fehler im Shop, siehe Problem melden. Abstürze und fehlgeschlagene Aufgaben findest du unter Logs.
Free und Premium
WebDonkey ist in Free voll benutzbar. Premium hebt die Grenzen auf und schaltet Bereiche frei, die über diesen Mac hinausgehen, etwa die Remote-Seiten für deine Server. Den Überblick gibt Free und Premium.