From 30433735fdb44e5c2769be215a9c73a8be8f3721 Mon Sep 17 00:00:00 2001 From: "svenja.michal" Date: Tue, 2 May 2023 15:39:59 +0200 Subject: [PATCH] Spelling and formatting updates --- .../01.de.md | 247 ++++++++++-------- .../01.en.md | 241 ++++++++++------- 2 files changed, 284 insertions(+), 204 deletions(-) diff --git a/tutorials/migrate-domains-websites-mails-and-databases-to-hetzner-web-hosting/01.de.md b/tutorials/migrate-domains-websites-mails-and-databases-to-hetzner-web-hosting/01.de.md index 863518961..3ce3d91cb 100644 --- a/tutorials/migrate-domains-websites-mails-and-databases-to-hetzner-web-hosting/01.de.md +++ b/tutorials/migrate-domains-websites-mails-and-databases-to-hetzner-web-hosting/01.de.md @@ -2,18 +2,17 @@ SPDX-License-Identifier: MIT path: "/tutorials/migrate-domains-websites-mails-and-databases-to-hetzner-web-hosting/de" slug: "migrate-domains-websites-mails-and-databases-to-hetzner-web-hosting" -date: "2022-11-11" +date: "2023-05-02" title: "Umzug von Domains, Websites, Mails und Datenbanken zum Hetzner Webhosting" -short_description: "Diese Anleitung erklärt, wie Sie Domains, Websites, Mails und Datenbanken von einem anderen Produkt oder einem anderen Provider nahtlos zu einem Webhosting-Paket von Hetzner migrieren können, während alles erreichbar und nutzbar bleibt." +short_description: "Dieses Tutorial erklärt, wie man Domains, Websites, Mails & Datenbanken von einem anderen Produkt oder Provider zu Hetzner migriert und alles erreichbar bleibt" tags: ["Domain Transfer", "Zone File", "Migration", "Wechsel", "Umstellung", "Auth Code", "Webspace", "FTP", "IMAP", "Sync", "Thunderbird", "FileZilla", "Export", "Import", "CSV", "MySQL", "MariaDB", "PostgreSQL", "phpMyAdmin", "phpPgAdmin", "mysqldump", "pg_dump", "pg_restore"] author: "Martin Badstübner" -author_link: "https://raw.githubusercontent.com/Martin555" +author_link: "https://github.com/Martin555" author_img: "https://avatars.githubusercontent.com/u/9485113" author_description: "" language: "de" available_languages: ["en", "de"] -header_img: "header-8" -cta: "web hosting" +header_img: "header-5" --- ## Einleitung @@ -29,7 +28,7 @@ Um Ihre Domain von einem anderen Provider auf einen Hetzner Webspace zu übertra 3. Vergewissern Sie sich, dass die Admin-Kontaktinformationen für die Domain auf dem neuesten Stand sind (Diese müssen mit den Daten übereinstimmen, die Sie für Ihr neues Hetzner konsoleH-Konto angeben werden). 4. Kündigen Sie Ihr Konto/Produkt bei Ihrem derzeitigen Provider und fügen Sie die Erklärung bei: `Diese Domain wird zu einem anderen Anbieter übertragen`. Achten Sie auf das Kündigungsdatum, da Sie die Migration vorher abschließen müssen. Alternativ können Sie das Konto auch behalten oder es einfach erst nach der Migration kündigen. 5. Wählen Sie eines unserer Webhosting-Pakete auf unserer [Website](https://www.hetzner.com/de/webhosting). Wenn Sie ein neuer Kunde sind, erstellen Sie ein Konto für unsere Verwaltungsoberfläche, die [konsoleH](https://konsoleh.hetzner.com/) heißt. -6. Bei der Bestellung des Webhosting-Kontos und der Auswahl Ihrer Domain in Schritt 2 geben Sie bitte den Auth-Code in das entsprechende Feld ein. Wenn Sie den Auth-Code Ihres alten Providers noch nicht haben, können Sie ihn später in einer Support-Anfrage an Hetzner senden. +6. Bei der Bestellung des Webhosting-Kontos und der Auswahl Ihrer Domain in Schritt 2, geben Sie bitte den Auth-Code in das entsprechende Feld ein. Wenn Sie den Auth-Code Ihres alten Providers noch nicht haben, können Sie diesen später in einer Support-Anfrage an Hetzner senden. Während Ihr konsoleH-Konto sofort aktiviert wird, dauert der Domaintransfer in der Regel 5-7 Werktage, je nach TLD (Top-Level-Domain). In der Zwischenzeit wird Ihre Domain weiterhin auf Ihren alten Server oder Webspace verweisen. Weitere Informationen finden Sie [hier](https://docs.hetzner.com/de/konsoleh/general/orders/change-of-provider/). @@ -46,7 +45,7 @@ Sobald Sie verbunden sind, sollten Sie alle Dateien auf Ihrem aktuellen Webspace Wenn Sie [FileZilla](https://filezilla-project.org/) verwenden, können Sie dies mit den folgenden Schritten bewerkstelligen: 1. Navigieren Sie auf der linken Seite des Programms zu dem gewünschten Download-Pfad. -2. Klicken Sie erneut auf der linken Seite mit der rechten Maustaste in den leeren Bereich der Dateiliste, wählen Sie `Verzeichnis erstellen` und geben Sie ihm einen Namen. Wechseln Sie nun in diesen Ordner. +2. Klicken Sie erneut auf der linken Seite mit der rechten Maustaste in den leeren Bereich der Dateiliste, wählen Sie `Verzeichnis erstellen` und geben Sie diesem einen Namen. Wechseln Sie nun in diesen Ordner. 3. Klicken Sie auf eine beliebige Datei in der Dateiliste auf der rechten Seite. 4. Drücken Sie dann `Strg`+`A`, um alle Dateien und Ordner zu markieren, klicken Sie mit der rechten Maustaste auf die ausgewählten Dateien und wählen Sie `Herunterladen`. Dadurch wird eine vollständige Kopie aller Dateien Ihrer Website in dem Ordner erstellt, den Sie auf der linken Seite ausgewählt haben. @@ -67,66 +66,73 @@ Wenn Sie [FileZilla](https://filezilla-project.org/) verwenden, können Sie dies Ihre Mail-Konten können entweder einzeln angelegt und anschließend mit den Mails aus dem alten Konto befüllt werden, oder Sie senden eine CSV-Datei per Support-Ticket ein, wodurch Ihre Konten angelegt und automatisch importiert werden können (empfohlen bei vielen Konten). -### Option 3.1 - Einzelner Import +- [Option 1 - Einzelner Import](#option-1---einzelner-import) +- [Option 2 - CSV-Import](#option-2---csv-import) + +### Option 1 - Einzelner Import Um alle E-Mail-Konten von Ihrem derzeitigen Provider herunterzuladen und dann auf Ihr neues Hetzner-Webhosting zu übertragen, benötigen Sie eine E-Mail-Software, die mit mehreren Konten umgehen kann und das Kopieren von E-Mails zwischen den Konten ermöglicht. Ich empfehle dazu [Thunderbird](https://www.thunderbird.net/de/) und werde Ihnen im Folgenden die Vorgehensweise mit dieser Software erläutern. Für jedes zu migrierende E-Mail-Konto (`XXX`@example.com) wiederholen Sie bitte die folgenden Schritte. -#### Schritt 3.1.1 - Hinzufügen des neuen E-Mail-Kontos - -Rufen Sie die [konsoleH](https://konsoleh.hetzner.com/mail.php/mailbox/list) auf und wählen Sie im Menü auf der linken Seite `Email` -> `Mailboxes`. -Klicken Sie dann auf `New mailbox` und füllen Sie das Formular aus. Der Wert in `Mailbox name` muss mit dem Namen Ihres aktuellen E-Mail-Kontos übereinstimmen. -Nachdem Sie auf `Save` geklickt haben, werden Ihre neuen Mailaccount-Anmeldedaten angezeigt, die Sie im nächsten Schritt benötigen. - -#### Schritt 3.1.2 - Verbinden Sie Ihren Mail-Client mit beiden Konten - -1. Klicken Sie in [Thunderbird](https://www.thunderbird.net/de/) auf die Menü-Schaltfläche (kleines Quadrat mit 3 horizontalen Linien), die Sie in der oberen rechten Ecke finden. -2. Dort klicken Sie bitte auf `Konto-Einstellungen`. -3. Klicken Sie nun auf der linken Seite auf `Konten-Aktionen` und wählen Sie `E-Mail-Konto hinzufügen`. -4. Geben Sie die Mailadresse und das Passwort des zu migrierenden Mailkontos ein und klicken Sie auf `Weiter`. -Wenn Thunderbird die Mailserver-Adressen nicht ermitteln konnte, geben Sie diese bitte manuell ein. Sie können die erforderlichen Adressen meist finden, indem Sie nach `mailProviderXY imap` googeln (ersetzen Sie *'mailProviderXY'* durch den Namen Ihres alten Providers). -5. Sobald das Konto erfolgreich hinzugefügt wurde, gehen Sie bitte zurück zu `Konto-Einstellungen`. Klicken Sie auf der linken Seite auf das neu angelegte Konto und ändern Sie den Wert im Feld `Konten-Bezeichnung` in einen Namen wie `Alt`. - -Wiederholen Sie diese Schritte, um Ihr neues E-Mail-Konto hinzuzufügen - aber diesmal klicken Sie bitte auf `Manuell einrichten`, nachdem Sie die E-Mail-Adresse und das Passwort eingegeben haben. -In dem Formular für die manuelle Konfiguration müssen Sie `mail.your-server.de` als Hostname für den Posteingangs- und Postausgangsserver eingeben. -Nachdem Sie das Konto hinzugefügt haben, benennen Sie es bitte in einen Namen wie `Neu` um. - -Zurück in der normalen Mail-Ansicht von Thunderbird sollten Sie nun zwei Konten in der Liste auf der linken Seite sehen - `Alt` und `Neu`. -Es empfiehlt sich nun, nacheinander auf alle Ordner unter dem Konto `Alt` zu klicken. Dadurch wird Thunderbird veranlasst, die Mails in diesen Ordnern herunterzuladen. - -#### Schritt 3.1.3 - Hochladen aller Mails auf den neuen Mailserver - -Bevor Sie fortfahren, warten Sie bitte, bis die Mailsoftware das Herunterladen aller Mails beendet hat. Bei Thunderbird wird diese Information in der Leiste am unteren Rand des Fensters angezeigt. Wenn diese Leiste leer ist, befindet sich Thunderbird im Leerlauf und Sie können fortfahren. - -Bitte wiederholen Sie die folgenden Schritte für alle Ordner unterhalb Ihres aktuellen E-Mail-Kontos (`Alt`): - -1. Klicken Sie auf einen Ordner in der Liste auf der linken Seite (z.B. `Entwürfe`). -2. Überprüfen Sie nun die Leiste am unteren Rand des Fensters. Wenn dort ein laufender Mail-Download angezeigt wird, warten Sie, bis er beendet ist. -3. Klicken Sie auf eine beliebige Mail und drücken Sie dann `Strg`+`A`, um alle Mails in diesem Ordner auszuwählen. -4. Klicken Sie nun mit der rechten Maustaste auf die ausgewählten Mails. -5. Wählen Sie `Kopieren in` -> `Neu` -> `Posteingang` -> `ZielOrdnerMitGleichemOderÄhnlichemNamen` (z.B. `Entwürfe` oder `Vorlagen`). - -Wenn im Zielkonto kein entsprechender Ordner vorhanden ist, können Sie einen erstellen, indem Sie mit der rechten Maustaste auf `Posteingang` unter dem Konto `Neu` klicken und `Neuer Ordner` wählen. Dies ist insbesondere für andere Ordner als die Standardordner wie Posteingang, Entwürfe, Gesendet und Papierkorb erforderlich. - -Sobald Sie alle Mails aus allen Ordnern Ihres aktuellen Kontos kopiert haben (vergessen Sie den Posteingang nicht), empfiehlt es sich, alle Ordner zu vergleichen, um sicherzustellen, dass bei der Kündigung des alten Kontos nichts verloren geht. Klicken Sie dazu einfach auf die betreffenden Ordner und Sie bekommen unten rechts die Anzahl der Mails in diesem Ordner angezeigt. - -### Option 3.2 - CSV-Import +- **Hinzufügen des neuen E-Mail-Kontos** + + Rufen Sie die [konsoleH](https://konsoleh.hetzner.com/mail.php/mailbox/list) auf und wählen Sie im Menü auf der linken Seite `Email` -> `Mailboxes`. + Klicken Sie dann auf `New mailbox` und füllen Sie das Formular aus. Der Wert in `Mailbox name` muss mit dem Namen Ihres aktuellen E-Mail-Kontos übereinstimmen. + Nachdem Sie auf `Save` geklickt haben, werden Ihre neuen Mailaccount-Anmeldedaten angezeigt, die Sie im nächsten Schritt benötigen. + +
+ +- **Verbinden Sie Ihren Mail-Client mit beiden Konten** + + 1. Klicken Sie in [Thunderbird](https://www.thunderbird.net/de/) auf die Menü-Schaltfläche (kleines Quadrat mit 3 horizontalen Linien), die Sie in der oberen rechten Ecke finden. + 2. Dort klicken Sie bitte auf `Konto-Einstellungen`. + 3. Klicken Sie nun auf der linken Seite auf `Konten-Aktionen` und wählen Sie `E-Mail-Konto hinzufügen`. + 4. Geben Sie die Mailadresse und das Passwort des zu migrierenden Mailkontos ein und klicken Sie auf `Weiter`. + Wenn Thunderbird die Mailserver-Adressen nicht ermitteln konnte, geben Sie diese bitte manuell ein. Sie können die erforderlichen Adressen meist finden, indem Sie nach `mailProviderXY imap` googeln (ersetzen Sie *"mailProviderXY"* durch den Namen Ihres alten Providers). + 5. Sobald das Konto erfolgreich hinzugefügt wurde, gehen Sie bitte zurück zu `Konto-Einstellungen`. Klicken Sie auf der linken Seite auf das neu angelegte Konto und ändern Sie den Wert im Feld `Konten-Bezeichnung` in einen Namen wie `Alt`. + + Wiederholen Sie diese Schritte, um Ihr neues E-Mail-Konto hinzuzufügen - aber diesmal klicken Sie bitte auf `Manuell einrichten`, nachdem Sie die E-Mail-Adresse und das Passwort eingegeben haben. + In dem Formular für die manuelle Konfiguration müssen Sie `mail.your-server.de` als Hostname für den Posteingangs- und Postausgangsserver eingeben. + Nachdem Sie das Konto hinzugefügt haben, benennen Sie es bitte in einen Namen wie `Neu` um. + + Zurück in der normalen Mail-Ansicht von Thunderbird sollten Sie nun zwei Konten in der Liste auf der linken Seite sehen - `Alt` und `Neu`. + Es empfiehlt sich nun, nacheinander auf alle Ordner unter dem Konto `Alt` zu klicken. Dadurch wird Thunderbird veranlasst, die Mails in diesen Ordnern herunterzuladen. + +
+ +- **Hochladen aller Mails auf den neuen Mailserver** + + Bevor Sie fortfahren, warten Sie bitte, bis die Mailsoftware das Herunterladen aller Mails beendet hat. Bei Thunderbird wird diese Information in der Leiste am unteren Rand des Fensters angezeigt. Wenn diese Leiste leer ist, befindet sich Thunderbird im Leerlauf und Sie können fortfahren. + + Bitte wiederholen Sie die folgenden Schritte für alle Ordner unterhalb Ihres aktuellen E-Mail-Kontos (`Alt`): + + 1. Klicken Sie auf einen Ordner in der Liste auf der linken Seite (z.B. `Entwürfe`). + 2. Überprüfen Sie nun die Leiste am unteren Rand des Fensters. Wenn dort ein laufender Mail-Download angezeigt wird, warten Sie, bis er beendet ist. + 3. Klicken Sie auf eine beliebige Mail und drücken Sie dann `Strg`+`A`, um alle Mails in diesem Ordner auszuwählen. + 4. Klicken Sie nun mit der rechten Maustaste auf die ausgewählten Mails. + 5. Wählen Sie `Kopieren in` -> `Neu` -> `Posteingang` -> `ZielOrdnerMitGleichemOderÄhnlichemNamen` (z.B. `Entwürfe` oder `Vorlagen`). + + Wenn im Zielkonto kein entsprechender Ordner vorhanden ist, können Sie einen erstellen, indem Sie mit der rechten Maustaste auf `Posteingang` unter dem Konto `Neu` klicken und `Neuer Ordner` wählen. Dies ist insbesondere für andere Ordner als die Standardordner wie Posteingang, Entwürfe, Gesendet und Papierkorb erforderlich. + + Sobald Sie alle Mails aus allen Ordnern Ihres aktuellen Kontos kopiert haben (vergessen Sie den Posteingang nicht), empfiehlt es sich, alle Ordner zu vergleichen, um sicherzustellen, dass bei der Kündigung des alten Kontos nichts verloren geht. Klicken Sie dazu einfach auf die betreffenden Ordner und Sie bekommen unten rechts die Anzahl der Mails in diesem Ordner angezeigt. + +### Option 2 - CSV-Import Für den automatischen Import per Ticket erstellen Sie bitte eine CSV-Datei mit folgendem Aufbau: `Domain`;`Mail-Adresse`;`Typ`;`Passwort`;`Kopie/Weiterleitungsadressen`;`IMAP-Server`;`IMAP-Benutzername`;`IMAP-Passwort` -| Wert | Erklärung | -|-----------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| Domain | Die Domain für die die Mailbox angelegt werden sollen. Diese muss auch in der konsoleH als Account oder Addon Domain angelegt sein. | -| Mail-Adresse | Dies ist der Teil vor dem @-Zeichen. | -| Typ | Ob eine Mailbox oder eine Weiterleitung angelegt werden soll: `MAILBOX` oder `ALIAS` | -| Passwort | Das Passwort für die Mailbox - wenn das Feld leer ist können Sie das Passwort nach dem Import in der konsoleH setzen. Bitte beachten Sie die Passwortrichtlinien:
Das Passwort muss mindestens 8 Zeichen lang sein und folgende Zeichen enthalten: mindestens einen Kleinbuchstaben: "a-z" und mindestens einen Großbuchstaben: "A-Z" und mindestens eine Zahl oder eines der folgenden Sonderzeichen: "0-9!$%()=?+#-.:~*@[]_" | -| Kopie/Weiterleitungsadressen (optional) | Hier können Sie Mailadressen eintragen, die bei eingehenden E-Mails diese in Kopie weitergeleitet bekommen (mehrere Adressen ggf. komma-getrennt eintragen) | -| IMAP-Server (optional) | Der entfernte IMAP Server, von dem die E-Mails initial abholt werden sollen. | -| IMAP-Benutzername (optional) | Der IMAP Benutzername dazu (häufig die entsprechende alte Mailadresse). | -| IMAP-Passwort (optional) | Das IMAP Passwort zu diesem entfernten Konto. | +| Wert | Erklärung | +| ---------------------------- | ------------------------------------ | +| Domain | Die Domain, für die die Mailbox angelegt werden soll. Diese muss auch in der konsoleH als Account oder Addon Domain angelegt sein. | +| Mail-Adresse | Dies ist der Teil vor dem @-Zeichen. | +| Typ | Ob eine Mailbox oder eine Weiterleitung angelegt werden soll: `MAILBOX` oder `ALIAS` | +| Passwort | Das Passwort für die Mailbox - wenn das Feld leer ist, können Sie das Passwort nach dem Import in der konsoleH setzen. Bitte beachten Sie die Passwortrichtlinien:
Das Passwort muss mindestens 8 Zeichen lang sein und folgende Zeichen enthalten:
  • Mindestens einen Kleinbuchstaben: "a-z"
  • Mindestens einen Großbuchstaben: "A-Z"
  • Mindestens eine Zahl oder eines der folgenden Sonderzeichen: "0-9!$%()=?+#-.:~*@[]_"
    • | +| Kopie/Weiterleitungsadressen (optional) | Hier können Sie Mailadressen eintragen, die bei eingehenden E-Mails diese in Kopie weitergeleitet bekommen (mehrere Adressen ggf. komma-getrennt eintragen) | +| IMAP-Server (optional) | Der entfernte IMAP Server, von dem die E-Mails initial abholt werden sollen. | +| IMAP-Benutzername (optional) | Der IMAP Benutzername dazu (häufig die entsprechende alte Mailadresse). | +| IMAP-Passwort (optional) | Das IMAP Passwort zu diesem entfernten Konto. | Die CSV-Datei senden Sie anschließend über die [konsoleH](https://konsoleh.hetzner.com/support.php) per Ticket an den Support. Beachten Sie bitte, dass bei sehr umfangreichen Imports eine Gebühr von 21 Euro (inkl. 19% MwSt.) je angefangener Viertelstunde erhoben wird. @@ -137,7 +143,11 @@ Wenn Sie Datenbanken in Ihrem alten Webhosting haben, können Sie diese exportie Melden Sie sich dazu bei [konsoleH](https://konsoleh.hetzner.com/database.php) an. Wählen Sie in der oberen Menüleiste den Punkt `Products` aus. Klappen Sie nun in der linken Menüleiste `Services` aus und klicken Sie auf `Databases` 🡲 `MariaDB/MySQL` oder `PostgreSQL` (je nach Ihrem aktuellen Datenbanksystem). Klicken Sie dann auf `Hinzufügen` und erstellen Sie eine Datenbank mit demselben Namen, wie die Datenbank, die Sie übertragen möchten. Es wird außerdem empfohlen, während der Migration alle Anwendungen zu stoppen, die Zugriff auf die Datenbank haben, um Änderungen an der alten Datenbank zu vermeiden, nachdem die Daten kopiert worden sind. +- [MariaDB/MySQL](#mariadbmysql) +- [PostgreSQL](#postgresql) + --- + ### MariaDB/MySQL #### MariaDB/MySQL-Datenbank exportieren @@ -146,34 +156,45 @@ Wenn Sie Zugriff auf die Datenbankverwaltungsoberfläche **phpMyAdmin** haben (z Alternativ können Sie auch die Kommandozeilen-Tools `mysql` und `mysqldump` verwenden. Sie können diese wie folgt installieren: -- Windows: - - Laden Sie [MySQL Workbench](https://dev.mysql.com/downloads/workbench/) herunter und installieren Sie es. - - Gehen Sie in den Installationsordner und kopieren Sie dessen Pfad. - - Sie können dann die genannten Tools in der CMD verwenden, indem Sie sie an diesen Pfad anhängen, z.B.: - - `C:\Program Files\MySQL Workbench XY\mysql.exe` - - `C:\Program Files\MySQL Workbench XY\mysqldump.exe` -- Ubuntu/Debian: - ```shell - apt install mysql-client - ``` -- CentOS/RHEL/Fedora: - ```shell - yum install mysql - ``` - ODER - ```shell - dnf install mysql - ``` -- MacOS: - ```shell - brew install mysql - ``` + +- **Windows:** + + - Laden Sie [MySQL Workbench](https://dev.mysql.com/downloads/workbench/) herunter und installieren Sie es. + - Gehen Sie in den Installationsordner und kopieren Sie dessen Pfad. + - Sie können dann die genannten Tools in der CMD verwenden, indem Sie sie an diesen Pfad anhängen, z.B.: + + - `C:\Program Files\MySQL Workbench XY\mysql.exe` + - `C:\Program Files\MySQL Workbench XY\mysqldump.exe` + +- **Ubuntu/Debian:** + + ```shell + apt install mysql-client + ``` + +- **CentOS/RHEL/Fedora:** + + ```shell + yum install mysql + ``` + ODER + ```shell + dnf install mysql + ``` + +- **MacOS:** + ```shell + brew install mysql + ``` Jetzt können Sie einen Dump der gesamten Datenbank wie folgt erstellen: + ```shell mysqldump -h alter-datenbank-host.com -u benutzername -p datenbank-name > dump.sql ``` + oder für Windows (suchen Sie nach `CMD` im Startmenü): + ```shell "C:\Program Files\MySQL Workbench XY\mysqldump.exe" -h alter-datenbank-host.com -u benutzername -p datenbank-name > dump.sql ``` @@ -183,15 +204,19 @@ oder für Windows (suchen Sie nach `CMD` im Startmenü): Da die [konsoleH](https://konsoleh.hetzner.com/database.php?type=mysql) die Datenbankverwaltungsoberfläche **phpMyAdmin** anbietet (klicken Sie auf den Stift hinter der jeweiligen Datenbank), können Sie einfach auf `Import` in der Navigationsleiste klicken, die erstellte Datei auswählen und dann auf `Go` klicken. Andernfalls führen Sie einfach diesen Befehl mit den neuen Zugangsdaten aus, die in der [konsoleH](https://konsoleh.hetzner.com/database.php?type=mysql) angezeigt werden, um die Datenbank auf Ihren neuen Hetzner-Datenbankhost zu importieren: + ```shell mysql -h sqlXXX.your-server.de -u benutzername -p datenbank-name < dump.sql ``` + oder für Windows: + ```shell "C:\Program Files\MySQL Workbench XY\mysql.exe" -h sqlXXX.your-server.de -u benutzername -p datenbank-name < dump.sql ``` --- + ### PostgreSQL #### PostgreSQL-Datenbank exportieren @@ -200,34 +225,46 @@ Wenn Sie Zugriff auf die Datenbankverwaltungsoberfläche **phpPgAdmin** haben (z Alternativ können Sie auch die Kommandozeilen-Tools `pg_dump` und `pg_restore` für die Migration verwenden. Sie können diese wie folgt installieren: -- Windows: - - Laden Sie [PostgreSQL](https://www.enterprisedb.com/downloads/postgres-postgresql-downloads) herunter und installieren Sie es. Im Installationsschritt `Select Components` brauchen Sie nur `Command Line Tools` zu wählen. - - Gehen Sie in den Installationsordner und kopieren Sie dessen Pfad. - - Sie können dann die genannten Tools in der CMD verwenden, indem Sie sie an den Pfad anhängen, z.B.: - - `C:\Program Files\PostgreSQL\XY\bin\pg_dump.exe` - - `C:\Program Files\PostgreSQL\XY\bin\pg_restore.exe` -- Ubuntu/Debian: - ```shell - apt install postgresql-client - ``` -- CentOS/RHEL/Fedora: - ```shell - yum install postgresql - ``` - ODER - ```shell - dnf install postgresql - ``` -- MacOS: - ```shell - brew install libpq - ``` + +- **Windows:** + + - Laden Sie [PostgreSQL](https://www.enterprisedb.com/downloads/postgres-postgresql-downloads) herunter und installieren Sie es. Im Installationsschritt `Select Components` brauchen Sie nur `Command Line Tools` zu wählen. + - Gehen Sie in den Installationsordner und kopieren Sie dessen Pfad. + - Sie können dann die genannten Tools in der CMD verwenden, indem Sie sie an den Pfad anhängen, z.B.: + + - `C:\Program Files\PostgreSQL\XY\bin\pg_dump.exe` + - `C:\Program Files\PostgreSQL\XY\bin\pg_restore.exe` + +- **Ubuntu/Debian:** + + ```shell + apt install postgresql-client + ``` + +- **CentOS/RHEL/Fedora:** + + ```shell + yum install postgresql + ``` + ODER + ```shell + dnf install postgresql + ``` + +- **MacOS:** + + ```shell + brew install libpq + ``` Jetzt können Sie einen Dump der gesamten Datenbank wie folgt erstellen: + ```shell pg_dump -d 'postgres://benutzername:passwort@alter-datenbank-host.com:5432/datenbank-name' -Fd -j 5 -f dump_verzeichniss ``` + oder für Windows (suchen Sie nach `CMD` im Startmenü): + ```shell "C:\Program Files\PostgreSQL\XY\bin\pg_dump.exe" -d 'postgres://benutzername:passwort@alter-datenbank-host.com:5432/datenbank-name' -Fd -j 5 -f dump_verzeichniss ``` @@ -237,21 +274,25 @@ oder für Windows (suchen Sie nach `CMD` im Startmenü): Wenn Sie die Datenbankverwaltungsoberfläche **phpPgAdmin** installiert haben (die konsoleH bietet diese für PostgreSQL nicht an, aber Sie können [Ihre eigene Installation verwenden](https://sourceforge.net/projects/phppgadmin/)), können Sie einfach in der Navigationsleiste auf `Import` klicken, die erstellte Datei auswählen und dann auf `Go` klicken. Andernfalls führen Sie zum Importieren der Datenbank auf Ihren neuen Hetzner-Datenbankhost einfach diesen Befehl mit den in der [konsoleH](https://konsoleh.hetzner.com/database.php?type=psq) angezeigten Anmeldeinformationen aus: + ```shell pg_restore --no-acl --no-owner -d 'postgres://benutzername:passwort@sqlXXX.your-server.de:5432/datenbank-name' --data-only -Fd -j5 dump_verzeichniss ``` + oder für Windows: + ```shell "C:\Program Files\PostgreSQL\XY\bin\pg_restore.exe" --no-acl --no-owner -d 'postgres://benutzername:passwort@sqlXXX.your-server.de:5432/datenbank-name' --data-only -Fd -j5 dump_verzeichniss ``` --- -Sobald die neue Datenbank eingerichtet und mit den Daten aus der alten gespeist ist, können Sie nun damit fortfahren, die Verbindungsdetails in Ihren Anwendungen auf die neue Datenbank zu ändern und diese wieder zu starten. + +Sobald die neue Datenbank eingerichtet und mit den Daten aus der Alten gespeist ist, können Sie nun damit fortfahren, die Verbindungsdetails in Ihren Anwendungen auf die neue Datenbank zu ändern und diese wieder zu starten. ## Fertigstellung Nachdem Sie alle Daten auf Ihr neues Webhosting migriert haben, ist es nun an der Zeit, Ihre Domain dorthin verweisen zu lassen. -Natürlich können Sie auch warten, bis der Domaintransfer abgeschlossen ist, aber das kann zu Differenzen zwischen Ihren duplizierten Daten führen (z.B. kommen neue Mails in der alten Mailbox an, die dann eine weitere Synchronisierung mit der neuen erfordern würden). +Natürlich können Sie auch warten, bis der Domaintransfer abgeschlossen ist, aber das kann zu Differenzen zwischen Ihren duplizierten Daten führen (z.B. kommen neue Mails in der alten Mailbox an, die dann eine weitere Synchronisierung mit der Neuen erfordern würden). Loggen Sie sich daher einfach in die Verwaltungsoberfläche Ihres alten Domain-Providers ein, gehen Sie zum Abschnitt DNS-Verwaltung und ändern Sie die autoritativen Nameserver auf [die von Hetzner/konsoleH](https://docs.hetzner.com/de/dns-console/dns/general/authoritative-name-servers#name-servers-for-konsoleh-customers). Wenn Sie Subdomains oder andere zusätzliche DNS-Einträge haben, ist es jetzt an der Zeit, diese von der Plattform Ihres alten Providers in die [konsoleH](https://konsoleh.hetzner.com/dns.php) zu übernehmen (`Services` 🡲 `Settings` 🡲 `DNS Administration`). diff --git a/tutorials/migrate-domains-websites-mails-and-databases-to-hetzner-web-hosting/01.en.md b/tutorials/migrate-domains-websites-mails-and-databases-to-hetzner-web-hosting/01.en.md index 569a901a8..5c355b188 100644 --- a/tutorials/migrate-domains-websites-mails-and-databases-to-hetzner-web-hosting/01.en.md +++ b/tutorials/migrate-domains-websites-mails-and-databases-to-hetzner-web-hosting/01.en.md @@ -2,18 +2,17 @@ SPDX-License-Identifier: MIT path: "/tutorials/migrate-domains-websites-mails-and-databases-to-hetzner-web-hosting" slug: "migrate-domains-websites-mails-and-databases-to-hetzner-web-hosting" -date: "2022-11-11" +date: "2023-05-02" title: "Migrate domains, websites, mails and databases to Hetzner web hosting" -short_description: "This tutorial explains how to seamlessly migrate domains, websites, mails and databases from a different product or another provider to a Hetzner web hosting package, while keeping everything reachable and usable." +short_description: "This tutorial explains how to migrate domains, websites, mails and databases from another product or provider to Hetzner, while keeping everything reachable." tags: ["Domain Transfer", "Zone File", "Move", "Relocation", "Auth Code", "Webspace", "FTP", "IMAP", "Sync", "Thunderbird", "FileZilla", "Export", "Import", "CSV", "MySQL", "MariaDB", "PostgreSQL", "phpMyAdmin", "phpPgAdmin", "mysqldump", "pg_dump", "pg_restore"] author: "Martin Badstübner" -author_link: "https://raw.githubusercontent.com/Martin555" +author_link: "https://github.com/Martin555" author_img: "https://avatars.githubusercontent.com/u/9485113" author_description: "" language: "en" available_languages: ["en", "de"] -header_img: "header-8" -cta: "web hosting" +header_img: "header-5" --- ## Introduction @@ -67,78 +66,86 @@ When using [FileZilla](https://filezilla-project.org/), you can achieve that by Your mail accounts can either be created individually and then populated with the mails from the old account, or you can send in a CSV file via support request, which allows your accounts to be created and imported automatically (recommended if you have many accounts). -### Option 3.1 - Individual Import +- [Option 1 - Individual Import](#option-1---individual-import) +- [Option 2 - CSV Import](#option-2---csv-import) + +### Option 1 - Individual Import In order to download all mail accounts from your current provider and then upload them to your new Hetzner web hosting, you need a mail software that is capable of handling multiple accounts and allows to copy mails between them. I therefore recommend using [Thunderbird](https://www.thunderbird.net) and will explain the procedure using this software hereafter. For each mail account to migrate (`XXX`@example.com), please repeat the following steps. -#### Step 3.1.1 - Add the new mail account - -Access the [konsoleH](https://konsoleh.hetzner.com/mail.php/mailbox/list) and choose `Email` -> `Mailboxes` from the menu on the left. -Then click `New mailbox` and fill out the form. The value in `Mailbox name` needs to be equal to the name of your current mail account. -After clicking `Save`, your new mail login credentials are displayed, which are required in the next step. - -#### Step 3.1.2 - Connect your mail client to both accounts - -1. In [Thunderbird](https://www.thunderbird.net) , please click on the menu button (small square with 3 horizontal lines), which you can find in the top right corner. -2. There, please click on `Account Settings`. -3. Please now click on `Account Actions` on the left side and choose `Add Mail Account`. -4. Enter the mail address and password of the current mail account to migrate and click on `Continue`. -If Thunderbird could not determine the mail server addresses, please manually enter them. You can often find them by googling for `mailProviderXY imap` (replace *'mailProviderXY'* with the name of your old provider). -5. Once the account has been successfully added, please navigate back to `Account Settings`. On the left side, please click on the new account and change the value in the field `Account Name` to something like `old`. - -Please repeat those steps to add your new mail account - but this time, please click on `Configure manually` after you entered the mail address and password. -In the manual configuration form, you need to fill in `mail.your-server.de` as hostname for both the incoming and outgoing server. -After you have added the account, please rename it to something like `new`. - -Back in the normal mail view of Thunderbird, you should now see two accounts in the list on the left side - `old` and `new`. -It is now recommended to one by one click on all folders under the account `old` . This will cause Thunderbird to download the mails in those folders. - -#### Step 3.1.3 - Upload all mails to the new mail server - -Before continuing, please wait for the mail software to finish downloading all mails. With Thunderbird, this information is shown on the bar at the bottom of the window. If this bar is empty, Thunderbird is idling and you can continue. - -Please repeat the following steps for all folders below your current mail account (`old`): - -1. Click on a folder in the list on the left side (e.g. `Drafts`). -2. Now check the bar at the bottom of the window. If it indicates a running mail download, wait for it to finish. -3. Click on any mail and then press `Ctrl`+`A` in order to select all mails in this folder. -4. Right-click on the selected mails. -5. Select `Copy To` -> `new` -> `Inbox` -> `TargetFolderWithSameOrEqualName` (e.g. `Drafts` or `Templates`). - -If there is no equal folder present at the target account, you can create one by doing a right click on `Inbox` under the account `new` and choosing `New Folder`. This is specifically required for folders, other than the default ones, like Inbox, Drafts, Sent and Trash. - -Once you have copied over all mails from all folders under your current account (don't forget `Inbox`), it is recommended to compare all folders, so you can ensure that nothing gets lost when cancelling the old account. Therefore, just click on the regarding folders and you will get the amount of mails in this folder displayed in the bottom right corner. - -### Option 3.2 - CSV Import +- **Add the new mail account** + + Access the [konsoleH](https://konsoleh.hetzner.com/mail.php/mailbox/list) and choose `Email` -> `Mailboxes` from the menu on the left. + Then click `New mailbox` and fill out the form. The value in `Mailbox name` needs to be equal to the name of your current mail account. + After clicking `Save`, your new mail login credentials are displayed, which are required in the next step. + +
    + +- **Connect your mail client to both accounts** + + 1. In [Thunderbird](https://www.thunderbird.net) , please click on the menu button (small square with 3 horizontal lines), which you can find in the top right corner. + 2. There, please click on `Account Settings`. + 3. Please now click on `Account Actions` on the left side and choose `Add Mail Account`. + 4. Enter the mail address and password of the current mail account to migrate and click on `Continue`. + If Thunderbird could not determine the mail server addresses, please manually enter them. You can often find them by googling for `mailProviderXY imap` (replace *"mailProviderXY"* with the name of your old provider). + 5. Once the account has been successfully added, please navigate back to `Account Settings`. On the left side, please click on the new account and change the value in the field `Account Name` to something like `old`. + + Please repeat those steps to add your new mail account - but this time, please click on `Configure manually` after you entered the mail address and password. + In the manual configuration form, you need to fill in `mail.your-server.de` as hostname for both the incoming and outgoing server. + After you have added the account, please rename it to something like `new`. + + Back in the normal mail view of Thunderbird, you should now see two accounts in the list on the left side - `old` and `new`. + It is now recommended to one by one click on all folders under the account `old` . This will cause Thunderbird to download the mails in those folders. + +
    + +- **Upload all mails to the new mail server** + + Before continuing, please wait for the mail software to finish downloading all mails. With Thunderbird, this information is shown on the bar at the bottom of the window. If this bar is empty, Thunderbird is idling and you can continue. + + Please repeat the following steps for all folders below your current mail account (`old`): + + 1. Click on a folder in the list on the left side (e.g. `Drafts`). + 2. Now check the bar at the bottom of the window. If it indicates a running mail download, wait for it to finish. + 3. Click on any mail and then press `Ctrl`+`A` in order to select all mails in this folder. + 4. Right-click on the selected mails. + 5. Select `Copy To` -> `new` -> `Inbox` -> `TargetFolderWithSameOrEqualName` (e.g. `Drafts` or `Templates`). + + If there is no equal folder present at the target account, you can create one by doing a right click on `Inbox` under the account `new` and choosing `New Folder`. This is specifically required for folders, other than the default ones, like Inbox, Drafts, Sent and Trash. + + Once you have copied over all mails from all folders under your current account (don't forget `Inbox`), it is recommended to compare all folders, so you can ensure that nothing gets lost when cancelling the old account. Therefore, just click on the regarding folders and you will get the amount of mails in this folder displayed in the bottom right corner. + +### Option 2 - CSV Import For the automatic import via support request, please create a CSV file with the following structure: `domain`;`mail address`;`type`;`password`;`copy/forwarding addresses`;`IMAP server`;`IMAP username`;`IMAP password` -| value | explanation | -|-----------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| domain | The domain for which the mailbox should be created. This domain must also be created in konsoleH as account or addon domain. | -| mail address | This is the part before the @ sign. | -| type | Whether a mailbox or a forwarding should be created: `MAILBOX` or `ALIAS`. | -| password | The password for the mailbox - if the field is empty you can set the password in konsoleH after the import. Please follow the password guidelines:
    The password must be at least 8 characters long and contain the following characters: at least one lowercase letter: "a-z" and at least one uppercase letter: "A-Z" and at least one number or one of the following special characters: "0-9!$%()=?+#-.:~*@[]_" | -| copy/forwarding addresses (optional) | Here you can enter mail addresses that will receive a copy of incoming e-mails (enter multiple addresses comma-separated if necessary). | -| IMAP server (optional) | The remote IMAP server from which the mails should be fetched initially. | -| IMAP username (optional) | The IMAP username for this (often the corresponding old mail address). | -| IMAP password (optional) | The IMAP password to this remote account. | +| value | explanation | +| ------------------------ | --------------------------------------- | +| domain | The domain for which the mailbox should be created. This domain must also be created in konsoleH as account or addon domain. | +| mail address | This is the part before the @ sign. | +| type | Whether a mailbox or a forwarding should be created: `MAILBOX` or `ALIAS`. | +| password | The password for the mailbox - if the field is empty you can set the password in konsoleH after the import. Please follow the password guidelines:
    The password must be at least 8 characters long and contain the following characters:
  • At least one lowercase letter: "a-z"
  • At least one uppercase letter: "A-Z"
  • At least one number or one of the following special characters: "0-9!$%()=?+#-.:~*@[]_"
    • | +| copy/forwarding addresses (optional) | Here you can enter mail addresses that will receive a copy of incoming e-mails (enter multiple addresses comma-separated if necessary). | +| IMAP server (optional) | The remote IMAP server from which the mails should be fetched initially. | +| IMAP username (optional) | The IMAP username for this (often the corresponding old mail address). | +| IMAP password (optional) | The IMAP password to this remote account. | Then send the CSV file via a support request from [konsoleH](https://konsoleh.hetzner.com/support.php). -Please note that for very extensive imports a fee of 17,01 Euro (excl. VAT) will be charged per started quarter hour. +Please note that very extensive imports will be charged with a fee of 17,65 Euro (excl. VAT) per started quarter hour. ## Step 4 - Database Migration If you have any databases in your old web hosting, you can export and re-import them into your new Hetzner database platform. -Therefore, please login to [konsoleH](https://konsoleh.hetzner.com/database.php). In the upper menu bar, select `Products`. Then, navigate to `Services` in the left menu bar and select `Databases` 🡲 `MariaDB/MySQL` or `PostgreSQL` (depending on your current database system). Then click `Add` and create a database with the same name, as the database you would like to transfer. +For this, please login to [konsoleH](https://konsoleh.hetzner.com/database.php). In the upper menu bar, select `Products`. Then, navigate to `Services` in the left menu bar and select `Databases` 🡲 `MariaDB/MySQL` or `PostgreSQL` (depending on your current database system). Then click `Add` and create a database with the same name, as the database you would like to transfer. It is also recommended to stop all applications during the migration, that have access to the database, in order to avoid changes to the old database after the data has been dumped. --- + ### MariaDB/MySQL #### Export MariaDB/MySQL database @@ -147,34 +154,46 @@ If you have access to the database administration interface **phpMyAdmin** (e.g. Alternatively, use the `mysql` and `mysqldump` command line tools. You can install them as follows: -- Windows: - - Download and install the [MySQL Workbench](https://dev.mysql.com/downloads/workbench/). - - Go to the installation folder and copy its path. - - You can then use the named tools in the CMD by appending them to this path, e.g.: - - `C:\Program Files\MySQL Workbench XY\mysql.exe` - - `C:\Program Files\MySQL Workbench XY\mysqldump.exe` -- Ubuntu/Debian: - ```shell - apt install mysql-client - ``` -- CentOS/RHEL/Fedora: - ```shell - yum install mysql - ``` - OR - ```shell - dnf install mysql - ``` -- MacOS: - ```shell - brew install mysql - ``` + +- **Windows:** + + - Download and install the [MySQL Workbench](https://dev.mysql.com/downloads/workbench/). + - Go to the installation folder and copy its path. + - You can then use the named tools in the CMD by appending them to this path, e.g.: + + - `C:\Program Files\MySQL Workbench XY\mysql.exe` + - `C:\Program Files\MySQL Workbench XY\mysqldump.exe` + +- **Ubuntu/Debian:** + + ```shell + apt install mysql-client + ``` + +- **CentOS/RHEL/Fedora:** + + ```shell + yum install mysql + ``` + OR + ```shell + dnf install mysql + ``` + +- **MacOS:** + + ```shell + brew install mysql + ``` Now you can create a dump of the whole database like so: + ```shell mysqldump -h old-database-host.com -u username -p database-name > dump.sql ``` + or for Windows (search for `CMD` in the start menu): + ```shell "C:\Program Files\MySQL Workbench XY\mysqldump.exe" -h old-database-host.com -u username -p database-name > dump.sql ``` @@ -184,15 +203,19 @@ or for Windows (search for `CMD` in the start menu): As the [konsoleH](https://konsoleh.hetzner.com/database.php?type=mysql) offers the database administration interface **phpMyAdmin** (click on the pencil behind the regarding database), you can simply click on `Import` in the navigation bar, select the dumped file and then hit `Go`. Else, to re-import the database to your fresh Hetzner database host, just execute this command with the new credentials, displayed in the [konsoleH](https://konsoleh.hetzner.com/database.php?type=mysql): + ```shell mysql -h sqlXXX.your-server.de -u username -p databasename < dump.sql ``` + or for Windows: + ```shell "C:\Program Files\MySQL Workbench XY\mysql.exe" -h sqlXXX.your-server.de -u username -p databasename < dump.sql ``` --- + ### PostgreSQL #### Export PostgreSQL database @@ -201,34 +224,46 @@ If you have access to the database administration interface **phpPgAdmin** (e.g. Alternatively, use the `pg_dump` and `pg_restore` command line tools for the migration. You can install them as follows: -- Windows: - - Download and install [PostgreSQL](https://www.enterprisedb.com/downloads/postgres-postgresql-downloads). In the installer step `Select Components`, you only need to select `Command Line Tools`. - - Go to the installation folder and copy its path. - - You can then use the named tools in the CMD by appending them to this path, e.g.: - - `C:\Program Files\PostgreSQL\XY\bin\pg_dump.exe` - - `C:\Program Files\PostgreSQL\XY\bin\pg_restore.exe` -- Ubuntu/Debian: - ```shell - apt install postgresql-client - ``` -- CentOS/RHEL/Fedora: - ```shell - yum install postgresql - ``` - OR - ```shell - dnf install postgresql - ``` -- MacOS: - ```shell - brew install libpq - ``` + +- **Windows:** + + - Download and install [PostgreSQL](https://www.enterprisedb.com/downloads/postgres-postgresql-downloads). In the installer step `Select Components`, you only need to select `Command Line Tools`. + - Go to the installation folder and copy its path. + - You can then use the named tools in the CMD by appending them to this path, e.g.: + + - `C:\Program Files\PostgreSQL\XY\bin\pg_dump.exe` + - `C:\Program Files\PostgreSQL\XY\bin\pg_restore.exe` + +- **Ubuntu/Debian:** + + ```shell + apt install postgresql-client + ``` + +- **CentOS/RHEL/Fedora:** + + ```shell + yum install postgresql + ``` + OR + ```shell + dnf install postgresql + ``` + +- **MacOS:** + + ```shell + brew install libpq + ``` Now you can create a dump of the whole database like so: + ```shell pg_dump -d 'postgres://username:password@old-database-host.com:5432/database-name' -Fd -j 5 -f dump_directory ``` + or for Windows (search for `CMD` in the start menu): + ```shell "C:\Program Files\PostgreSQL\XY\bin\pg_dump.exe" -d 'postgres://username:password@old-database-host.com:5432/database-name' -Fd -j 5 -f dump_directory ``` @@ -238,15 +273,19 @@ or for Windows (search for `CMD` in the start menu): If you have the database administration interface **phpPgAdmin** installed (the konsoleH does not offer it for PostgreSQL, but you can [use your own installation](https://sourceforge.net/projects/phppgadmin/)), you can simply click on `Import` in the navigation bar, select the dumped file and then hit `Go`. Else, to re-import the database to your fresh Hetzner database host, just execute this command with the credentials, displayed in the [konsoleH](https://konsoleh.hetzner.com/database.php?type=psql): + ```shell pg_restore --no-acl --no-owner -d 'postgres://username:password@sqlXXX.your-server.de:5432/database-name' --data-only -Fd -j5 dump_directory ``` + or for Windows: + ```shell "C:\Program Files\PostgreSQL\XY\bin\pg_restore.exe" --no-acl --no-owner -d 'postgres://username:password@sqlXXX.your-server.de:5432/database-name' --data-only -Fd -j5 dump_directory ``` --- + Once the new database is set up and fed with the data from the old one, you can now proceed changing the connection details in your applications to the new database and start them again. ## Finalization