Lokal holen
Free & PremiumAuf der Seite Lokal holen holst du eine Website von deinem Server auf diesen Mac und arbeitest lokal daran weiter. Projektordner und Datenbank kommen per SSH herüber und werden zu einer Site mit .test-Adresse unter Sites. Der Server wird dabei nur gelesen. Lokal holen geht auch ohne Premium. Mit Premium macht WebDonkey die Kopie zusätzlich lauffähig.
Was du hier machst
- im Formular Verbindung, Projektordner, DocRoot, Name und Optionen wählen
- mit der Vorabprüfung sehen, ob das Holen klappen wird, bevor auf dem Mac etwas entsteht
- Ablauf und Ergebnis verfolgen und die fertige Kopie im Browser oder Editor öffnen
Aufbau der Seite
- Kopf: Lokal holen mit dem Satz Hol eine Website von deinem Server auf diesen Mac und arbeite lokal daran weiter.
- Links die Liste Verbindungen wie auf den anderen Remote-Seiten (mit Premium). Ein Klick auf einen Server startet das Formular neu mit dieser Verbindung. In Free bleibt die Liste leer, du wählst die Verbindung im Formular.
- Rechts die Karte Projekt lokal holen mit dem Formular. Während ein Lauf läuft, zeigt sie stattdessen den Fortschritt (… wird geholt).
So gehst du vor
- Öffne in der Seitenleiste Remote › Lokal holen, oder tippe „Lokal holen“ in ⌘K.
- Wähle die Verbindung und klicke auf Testen, oder lege mit Neue Verbindung… eine an.
- Wähle mit Wählen… den Projektordner auf dem Server. WebDonkey liest das Projekt und zeigt, was es gefunden hat.
- Prüfe DocRoot (relativ zum Projektordner), Name der Site und Lokale Adresse.
- Entscheide über Datenbank holen, Mediendateien holen und Kopie lauffähig machen.
- Bestätige bei einer Datenbank den Hinweis zu den Personendaten.
- Klicke auf Lokal holen. Erst läuft die Vorabprüfung, danach das Holen.
Welche Projekte gehen
| Projekt | Was passiert |
|---|---|
| Shopware 6, WordPress, WooCommerce, Magento 2 | Dateien und Datenbank werden geholt, die Kopie wird immer sicher gemacht |
| andere Projekte ohne Datenbank oder mit SQLite | Dateien werden geholt, die Site wird eingetragen |
| andere Systeme mit einer Datenbank auf dem Server (etwa Laravel, Symfony, Drupal, TYPO3) | werden nicht geholt, weil WebDonkey ihre Konfiguration nicht sicher auf eine lokale Datenbank umstellen kann |
Geholt werden nur MySQL- und MariaDB-Datenbanken.
Free und Premium
| Free | Premium | |
|---|---|---|
| Dateien und Datenbank holen, Site anlegen | ja | ja |
| Kopie sicher machen (lokale Datenbank, Mails an Mailpit, geplante Aufgaben aus, Zugänge externer Dienste geleert) | ja | ja |
| Verbindung im Formular wählen oder neu anlegen | ja | ja |
| Verbindungsliste links | leer | ja |
Kopie lauffähig machen (Adressen auf .test, Redis und Suchdienst aus) |
nein | ja |
Ohne Premium behält die Kopie die Adressen der Live-Website. Was Premium sonst freischaltet, steht unter Free, Premium und Grenzen.
Personendaten
Holst du die Datenbank, kommen die Personendaten der Website unverändert auf diesen Mac: Kunden, Bestellungen, Konten und alles, was die Datenbank sonst speichert. Deshalb fragt WebDonkey vorher nach deiner Bestätigung. Ist es die Website eines Kunden, muss eure Vereinbarung das abdecken (Auftragsverarbeitung). Schütze den Mac mit FileVault und lösche die Kopie, wenn du sie nicht mehr brauchst.
Das Formular Free & Premium
Im Formular Projekt lokal holen legst du fest, was vom Server kommt und wie die Kopie auf deinem Mac heißt. Die Felder erscheinen Schritt für Schritt: erst die Verbindung, dann der Projektordner. Erst wenn WebDonkey das Projekt gelesen hat, folgen DocRoot, Name und Optionen.
So findest du es
Seitenleiste Remote › Lokal holen. Das Formular ist die Karte rechts.
So gehst du vor
- Verbindung: Wähle den Server aus der Liste. Jede Zeile zeigt Name und
benutzer@host. Testen meldet sich an und zeigt bei Erfolg Verbunden. Home-Ordner: …. - Projektordner auf dem Server: Klicke auf Wählen… oder ins Feld. Im Dialog Projektordner wählen gehst du mit einem Klick in einen Ordner, mit Hoch eine Ebene höher, und übernimmst mit Diesen Ordner wählen.
- WebDonkey liest das Projekt (Projekt auf dem Server wird gelesen…) und zeigt einen Kasten mit dem Ergebnis.
- Prüfe DocRoot (relativ zum Projektordner).
- Passe Name der Site und Lokale Adresse an.
- Wähle die Optionen.
- Hake bei einer Datenbank die Bestätigung zu den Personendaten an.
- Klicke auf Lokal holen.
Gemeint ist der Ordner des ganzen Projekts, mit composer.json, wp-config.php oder app/etc, nicht nur der öffentliche Ordner. Wählst du einen Ordner, der wie ein öffentlicher Ordner aussieht, schlägt der Kasten den Elternordner vor: Elternordner verwenden übernimmt ihn.
Neue Verbindung anlegen
Neue Verbindung… öffnet einen kleinen Dialog, der auch in Free geht:
| Feld | Bedeutung |
|---|---|
| Server | Adresse des Servers. Pflicht. |
| Port | Standard 22 |
| Benutzer | SSH-Benutzer. Pflicht. |
| Name | Anzeigename. Leer nimmt WebDonkey benutzer@host. |
| Anmelden mit | Passwort, SSH-Schlüssel oder SSH-Agent |
| Schlüsseldatei | bei SSH-Schlüssel, Standard ~/.ssh/id_ed25519 |
| Passphrase (falls vorhanden) | bei SSH-Schlüssel |
| Passwort | bei Passwort. Pflicht. |
Speichern und testen speichert die Verbindung und meldet sich einmal an. Das Passwort liegt verschlüsselt auf diesem Mac. Klappt die Anmeldung nicht, ist die Verbindung trotzdem gespeichert (Die Verbindung ist gespeichert, der Server war aber nicht erreichbar.), und Erneut testen versucht es noch einmal. Die neue Verbindung steht danach auch auf allen anderen Remote-Seiten.
Was WebDonkey im Projekt findet
Der Kasten nach dem Lesen zeigt:
- das System mit Version und Edition, etwa Shopware oder WordPress, mit Marke zum Support-Stand,
- PHP mit der Version, die das Projekt auf dem Server nutzt,
- Datenbank mit Name und Datenbankserver, ebenfalls mit Marke,
- Hinweise in Gelb, etwa wenn die Datenbank vom Server aus nicht erreichbar war oder kein Dump-Programm gefunden wurde.
Die Marken an den Versionen bedeuten dasselbe wie bei der Server-Software.
Felder und Optionen
| Feld | Bedeutung | Standard |
|---|---|---|
| DocRoot (relativ zum Projektordner) | der öffentliche Ordner der Website, relativ zum Projektordner, etwa public. . steht für den Projektordner selbst. Wählen… öffnet DocRoot wählen. |
erkannt. Ist er nicht eindeutig, bietet WebDonkey Vorschläge als Knöpfe an, das Feld ist dann Pflicht. |
| Name der Site | Name in der Liste der Sites | aus dem Projekt vorgeschlagen |
| Lokale Adresse | der Teil vor .test. Aus „Mein Shop“ wird mein-shop.test. Ist der Name vergeben, hängt WebDonkey -2, -3 … an. |
aus dem Namen |
| Datenbank holen | holt die Datenbank und legt eine lokale an. Gesperrt mit Im Projekt wurde keine Datenbank gefunden., wenn es keine gibt. | an, wenn das Projekt eine Datenbank hat |
| Mediendateien holen | Uploads und Produktbilder. Ohne sie läuft die Kopie, Bilder fehlen. | an |
| Kopie lauffähig machen | Adressen auf .test umschreiben (auch in serialisierten Daten), Redis und Suchdienst aus. Die Kopie läuft dann auf diesem Mac. Nur mit Premium, in Free trägt sie die Marke Premium. |
an mit Premium |
| Adresse der Live-Website | nur bei Shopware 6, WordPress, WooCommerce und Magento 2. Aus der Konfiguration übernommen, wenn gefunden. Leer liest WebDonkey sie aus der Kopie. Muss mit http:// oder https:// beginnen. |
gefunden oder leer |
Unter den Optionen steht, was mit der Kopie passiert, solange Kopie lauffähig machen aus ist: Die Kopie wird sicher gemacht (bei einer Datenbank) oder dass eine leere lokale Datenbank entsteht (ohne Datenbank).
Die Bestätigung zu den Personendaten
Holst du die Datenbank, erscheint ein gelb umrandeter Kasten: Die Kopie enthält echte Personendaten, und ich darf sie auf diesen Mac holen. Ohne Haken bleibt Lokal holen gesperrt. WebDonkey merkt sich den Haken für diese Verbindung und diesen Projektordner, beim nächsten Holen ist er schon gesetzt.
Erweitert: Datenbank-Zugang
Unter dem Formular klappt Erweitert den Datenbank-Zugang auf. Normalerweise brauchst du ihn nicht, WebDonkey liest die Zugangsdaten aus der Konfiguration des Projekts (.env.local, wp-config.php, env.php …). Darüber steht, woher die Werte kommen: Vorbelegt aus … mit der Datei, Vorbelegt aus den Umgebungsvariablen des Servers oder Für dieses Projekt gespeichert.
| Feld | Bedeutung |
|---|---|
| Host, Port, Socket | wie das Projekt die Datenbank erreicht |
| Datenbank, Benutzer | Name der Datenbank und Datenbank-Benutzer |
| Passwort | leer lassen behält das gespeicherte oder das aus der Konfiguration |
| Dump-Programm | Automatisch (empfohlen), eines der gefundenen Programme mit Version, Ohne Dump-Programm (PHP) oder Eigener Pfad…. passt nicht zum Server steht bei einem MySQL-Programm für einen MariaDB-Server und umgekehrt. |
Verbindung testen meldet sich mit diesen Angaben an und zeigt das Ergebnis als Liste. Speichern merkt sie sich (Gespeichert. Die nächste Prüfung nutzt diesen Zugang.), Auf Konfiguration zurücksetzen löscht das Gespeicherte. Was du nicht änderst, folgt weiter der Konfiguration. Der Zugang gilt je Verbindung und Projektordner, das Passwort liegt verschlüsselt auf diesem Mac und geht nur über die SSH-Verbindung an den Server, nie in einer Befehlszeile.
Scheitert die Vorabprüfung an der Datenbank, klappt der Datenbank-Zugang von selbst auf.
Wenn es nicht klappt
| Was du siehst | Was du tust |
|---|---|
| Noch keine Verbindung in der Auswahl | Mit Neue Verbindung… eine anlegen |
| Kein eindeutiger DocRoot gefunden: bitte angeben. | Einen Vorschlag anklicken oder den Ordner mit Wählen… angeben |
| Der DocRoot muss im Projektordner liegen. | Einen Ordner innerhalb des Projektordners wählen |
| Eine Kopie dieses Projekts kann WebDonkey nicht sicher machen | Das System hat eine Datenbank auf dem Server und lässt sich nicht sicher umstellen. Hol es ohne Datenbank oder richte es von Hand ein. |
| Bitte eine vollständige Adresse angeben, z. B. https://www.example.com. | Die Live-Adresse mit https:// eintragen oder das Feld leeren |
| Hinweis Mehrere WordPress unter dem gewählten Ordner | Den Ordner einer der Installationen wählen |
Siehe auch
Vorabprüfung Free
Bevor auf diesem Mac etwas entsteht, prüft WebDonkey, ob das Holen klappen wird: Verbindung, PHP auf dem Server, Projektordner, Datenbank, freier Platz auf beiden Seiten und das lokale Ziel. Jeder Punkt, der nicht passt, nennt den Grund und den Weg zur Lösung. Solange ein Punkt rot ist, startet nichts.
So findest du es
Seitenleiste Remote › Lokal holen. Die Prüfung startet, wenn du im Formular auf Lokal holen klickst. Während sie läuft, steht dort WebDonkey prüft, ob das Holen klappen wird….
So gehst du vor
- Fülle das Formular aus und klicke auf Lokal holen.
- Lies das Ergebnis über den Knöpfen:
- Alles bereit. Das Holen startet sofort.
- Das Holen klappt. Beachte die Hinweise. Mindestens ein Punkt ist gelb. Der Knopf heißt jetzt Trotzdem holen und startet beim nächsten Klick.
- So klappt das Holen nicht. Behebe die rot markierten Punkte und prüf erneut. Es startet nichts.
- Behebe rote Punkte und klicke auf Erneut prüfen.
Eine Prüfung gilt nur für genau die Angaben, mit denen sie lief. Änderst du danach etwas im Formular, prüft WebDonkey beim nächsten Klick neu.
Die Punkte der Prüfung
Jeder Punkt steht mit grünem Haken, gelbem Warnzeichen oder rotem Zeichen da, dazu der Grund und was du tust.
| Punkt | Was geprüft wird |
|---|---|
| Verbindung zum Server | SSH-Anmeldung und ob der Helfer von WebDonkey auf dem Server startet |
| PHP auf dem Server | ein PHP für die Kommandozeile, 7.4 oder neuer |
| Projektordner lesbar | ob der SSH-Benutzer den Projektordner lesen darf |
| Document Root vorhanden | ob es den DocRoot im Projektordner gibt |
| Anmeldung an der Datenbank | Login mit den Zugangsdaten aus der Konfiguration oder dem gespeicherten Datenbank-Zugang |
| Weg zum Sichern der Datenbank | ein passendes Dump-Programm, sonst der Weg über PHP |
| Platz auf dem Server für den Dump | freier Platz im Home-Ordner auf dem Server |
| Platz auf diesem Mac | freier Platz für Dump, Archiv, Dateien und lokale Datenbank |
| Lokales Ziel frei | ob Name und Adresse der Kopie frei sind |
| Datenbank-Dienst auf diesem Mac | ob MySQL oder MariaDB installiert ist |
Ohne Datenbank entfallen die Datenbank-Punkte.
Der freie Platz
Die beiden Platz-Punkte zeigen je Datenträger, was der Lauf braucht und was frei ist: Benötigt ca. …, dazu … Reserve und frei … von …. Als Reserve bleiben nach dem Lauf mindestens 500 MB frei, bei großen Kopien 15 % dessen, was der Lauf dort schreibt. Gelb heißt Knapp, aber es reicht, rot nennt, wie viel fehlt. Auf dem Mac steht dabei, wie viel davon macOS bei Bedarf selbst freigibt (zum Beispiel Caches). Meldet der Server ein Speicherkontingent, gilt dessen freier Platz.
Was im Hintergrund passiert
- Die Prüfung liest nur. Auf dem Server fragt sie den Projektordner, die Datenbank und den Platz ab, auf dem Mac den Platz und die vorhandenen Sites. Es entsteht nichts.
- Für Weg zum Sichern der Datenbank probiert WebDonkey jedes passende Dump-Programm auf dem Server kurz aus (
mysqldump,mariadb-dumpund übliche Orte bei Hostern), das mit der nächsten Version zuerst. Programme, die nicht zum Datenbankserver passen, nimmt es nicht. Findet es keines, liest es die Datenbank mit PHP. Das dauert länger, das Ergebnis ist gleich. - Auf Hosts mit mehreren Datenbankservern verbindet sich WebDonkey wie die Website selbst, auch über den Socket, den der Datenbankserver nennt.
- Ein Lauf, der ohne diese Prüfung startet, prüft die Datenbank zu Beginn selbst und hält genauso früh an.
Wenn es nicht klappt
| Was du siehst | Was du tust |
|---|---|
| Der Server ist nicht erreichbar oder lehnt die Anmeldung ab. | Verbindung mit Testen prüfen, Zugangsdaten kontrollieren |
| Der WebDonkey-Helfer ließ sich auf dem Server nicht starten. | Details ansehen. Oft hilft eine andere PHP-Version beim Hoster. |
| Auf dem Server gibt es kein passendes PHP für die Kommandozeile. | Beim Hoster PHP 7.4 oder neuer für die Kommandozeile aktivieren |
| Diesen Projektordner darf dieser Benutzer nicht lesen. | Mit dem Benutzer verbinden, dem das Projekt gehört |
| Die Datenbank hat die Anmeldung abgelehnt. | Benutzer und Passwort unter Datenbank-Zugang prüfen. Läuft die Website selbst, fehlt meist nur der richtige Socket oder Host. |
| Eine Datenbank mit diesem Namen gibt es auf dem Server nicht. | Den richtigen Namen unter Datenbank-Zugang eintragen |
| Der Datenbankserver war nicht erreichbar. | Host und Port oder den Socket der Website unter Datenbank-Zugang eintragen |
| Dem PHP auf dem Server fehlt die Erweiterung pdo_mysql. | Beim Hoster eine PHP-Version mit pdo_mysql wählen |
| Kein passendes Dump-Programm gefunden. (gelb) | Nichts nötig, WebDonkey nimmt PHP. Kennst du ein Programm, trag es unter Datenbank-Zugang ein. |
| Auf diesem Mac ist weder MySQL noch MariaDB installiert. | Unter Services MySQL oder MariaDB installieren |
| Der Name ist schon vergeben. Die Kopie bekommt einen anderen. (gelb) | Nichts nötig, oder einen anderen Namen wählen |
| Zu wenig Platz auf dem Server oder dem Mac | Platz schaffen oder Mediendateien holen abwählen |
Meldet der Server einen Fehler, steht er als Satz da. Details klappt die Meldung des Servers auf.
Siehe auch
Ablauf und Ergebnis Free
Nach bestandener Vorabprüfung holt WebDonkey Datenbank und Dateien, legt die lokale Datenbank an, macht die Kopie sicher und trägt sie als Site ein. Die Karte zeigt jeden Schritt, den freien Platz während des Laufs und am Ende alles, was du zum Arbeiten brauchst.
So findest du es
Seitenleiste Remote › Lokal holen. Sobald ein Lauf startet, zeigt die Karte statt des Formulars … wird geholt mit der Liste der Schritte. Der Lauf geht weiter, wenn du die Seite verlässt. Kommst du zurück, siehst du wieder seinen Stand.
Die Schritte
| Schritt | Was passiert |
|---|---|
| Projekt lesen | WebDonkey liest das Projekt noch einmal und prüft die Datenbank |
| Datenbank auf dem Server sichern | ein Dump der Datenbank entsteht auf dem Server, in einer Lese-Transaktion |
| Dump herunterladen | der Dump kommt auf den Mac und wird auf dem Server gleich wieder gelöscht |
| Dateien herunterladen | der Projektordner kommt als ein gepacktes Archiv herüber, die Karte zeigt die schon geladene Menge |
| Dateien entpacken | das Archiv wird in den Ordner der neuen Site entpackt |
| Lokale Datenbank anlegen | eine neue Datenbank mit eigenem Benutzer und Passwort, in MySQL oder MariaDB auf diesem Mac |
| Dump einspielen | der Dump geht in die lokale Datenbank |
| Kopie sicher machen | die Konfiguration zeigt auf die lokale Datenbank, Mails gehen an Mailpit, geplante Aufgaben sind aus, Zugänge externer Dienste sind geleert. Mit Premium macht WebDonkey die Kopie hier auch lauffähig. |
| Site eintragen | die Kopie erscheint unter Sites mit ihrer .test-Adresse |
Holst du keine Datenbank, fallen die Datenbank-Schritte weg. Bei Shopware 6, WordPress, WooCommerce und Magento 2 entsteht dann trotzdem eine leere lokale Datenbank, damit die Kopie nie die Live-Datenbank oder den Live-Mailserver erreicht.
Speicherplatz während des Laufs
Unter den Schritten steht Speicherplatz während des Laufs mit dem, was der Lauf noch braucht. Vor jedem großen Schritt misst WebDonkey den Platz neu und startet den Schritt nur, wenn danach die Reserve frei bleibt (mindestens 500 MB). Wird knapp und Fast voll warnen vorher. Reicht der Platz nicht, hält der Lauf an, entfernt, was er angelegt hat, und meldet es in der Glocke.
Abbrechen
Abbrechen stoppt den Lauf zwischen zwei Schritten oder beim Einspielen. WebDonkey entfernt dann, was auf diesem Mac angelegt wurde: Ordner, lokale Datenbank und Benutzer. Dasselbe passiert, wenn ein Schritt scheitert. Am Server ändert sich in keinem Fall etwas.
Das Ergebnis
Am Ende steht … ist bereit mit diesen Angaben:
| Angabe | Inhalt |
|---|---|
| Adresse | die lokale Adresse, https://…test oder http://…test |
| Projektordner | Ordner der Kopie im Standardordner für Sites |
| DocRoot | der öffentliche Ordner der Kopie |
| PHP | die PHP-Version der Site |
| Datenbank | Name, Art, Host und Port der lokalen Datenbank |
| Benutzer, Passwort | der Zugang zur lokalen Datenbank |
Darüber stehen kurze Sätze, etwa Enthält echte Personendaten., Sicher gemacht: lokale Datenbank, Mails an Mailpit, geplante Aufgaben aus. oder Konfiguration für diesen Mac umgeschrieben. (mit Premium). Hinweise in Gelb nennen, was du noch prüfen solltest.
- Öffnen startet, was die Site braucht, und öffnet sie im Browser.
- Im Editor öffnen öffnet den Projektordner im Code-Editor.
- Fertig schließt das Ergebnis und zeigt wieder das Formular.
Die Site findest du danach auch unter Sites.
Was im Hintergrund passiert
- Der Server wird nur gelesen: das Projekt, ein Dump in einer Lese-Transaktion und ein Archiv des Projektordners. Den Dump löscht WebDonkey dort, sobald er auf dem Mac ist.
- Caches und Logs des Systems kommen nicht mit (die Ordner bleiben, leer). Ohne Mediendateien holen fehlen die Medienordner.
- Name und Adresse der Kopie sind immer frei: Ist
shop.testvergeben, wird esshop-2.test. - Die Adresse bekommt HTTPS, solange deine Grenze für Sites mit HTTPS das zulässt (in Free 3), sonst HTTP.
- Fehlt die PHP-Version des Servers auf deinem Mac, nutzt die Site das Standard-PHP.
- Lässt sich nicht bestätigen, dass Datenbank und Mails der Kopie lokal bleiben, entfernt WebDonkey die Kopie wieder.
Wenn es nicht klappt
| Was du siehst | Was du tust |
|---|---|
| Das Holen hat nicht geklappt. Was auf diesem Mac angelegt wurde, ist wieder entfernt. | Den Grund darunter lesen, Details zeigt die Meldung des Servers. Behebe ihn und hol erneut. |
| Hinweis Die PHP-Version des Servers ist hier nicht installiert | Unter Services die passende PHP-Version installieren und der Site zuweisen |
| Hinweis Mailpit ist nicht installiert | Mailpit unter Services installieren, sonst gehen Mails der Kopie nirgendwohin |
| Hinweis Webserver oder PHP ließen sich noch nicht starten. | Dienste unter Services starten |
| Hinweis Nicht jeder Punkt der Konfiguration ließ sich bestätigen. | Die Kopie prüfen, bevor du sie nutzt |
| Hinweis zum Deployer-Layout | Links auf Releases und gemeinsame Ordner können auf Serverpfade zeigen. Die Links im Projektordner prüfen. |
| Gerade wird schon eine Kopie dieser Website angelegt. | Den laufenden Lauf abwarten |
| Der Sites-Ordner in den Einstellungen ist kein absoluter Pfad. | Unter Einstellungen › Sites & Dienste bei Standardordner für Sites einen absoluten Ordner wählen |