imapsync: Parameter gegen fehlende E-Mails

imapsync ist das Werkzeug der Wahl, um IMAP-E-Mails ohne PST-Exporte, Desktopclients oder ein Wochenende voller Rätselraten umzuziehen. Das Problem beginnt beim nächsten Schritt. Ein falscher Parameter, eine schlechte Ordnerzuordnung oder ein Irrtum bei der Authentifizierung genügt, und die Migration endet mit fehlenden gesendeten Nachrichten, doppelten Ordnern oder neuen E-Mails, die bei der Umschaltung gelöscht werden. Den vollständigen Ablauf erklärt dieser Praxisleitfaden zu imapsync.

Dieser Artikel konzentriert sich bewusst auf die imapsync-Parameter, die Ergebnisse verändern: Zeitüberschreitungen, Keepalives, Ordnerzuordnung, Drosselung, Deduplizierung und gefährliche Löschoptionen. Bei einem Konto verhindern sie einen aufwendigen Neustart. Bei fünfzig Konten ersparen sie die Erklärung, warum der Gesendet-Ordner eines Kunden plötzlich dreifach vorhanden ist.

Kurz gesagt: Die Standardeinstellungen von imapsync sind kein Migrationsplan, sondern ein Ausgangspunkt. Echte Migrationen brauchen gestaffelte Läufe, klare Ordnerregeln und eine Prüfung vor Änderungen am MX-Eintrag. Ist TrekMail das Ziel, übernimmt der integrierte Importassistent kostenpflichtiger Tarife die Empfängerseite im Dashboard. Das ist schneller als die manuelle Verwaltung jedes Postfachs per Shellskript. TrekMail beginnt bei $3.50/month, nutzt gemeinsam genutzten Speicher statt Nutzergebühren und unterstützt serverseitige IMAP-Importe aus Gmail, Outlook, Yahoo, iCloud und allgemeinen IMAP-Diensten.

Warum imapsync mit blind vertrauten Standardwerten scheitert

imapsync kopiert zwischen aktiven IMAP-Speichern, nicht zwischen einfachen Dateien. Während das Netzwerk Sitzungen unterbrechen kann, muss es unterschiedliche Ordnerhierarchien, Servereigenheiten, Nachrichtenkennungen und Authentifizierungsmodelle berücksichtigen. Sichere Aufrufe sind deshalb ausführlicher als kopierte Forenbeispiele.

Die häufigsten Fehler sind unspektakulär und teuer:

Große Nachrichten laufen beim Upload in eine Zeitüberschreitung.
Ordnernamen werden falsch zugeordnet, sodass E-Mails verschwunden wirken.
Anbieter drosseln den Auftrag und lehnen Verbindungen ab.
Moderne Authentifizierung blockiert einfache Passwörter.
Änderungen des UID-Zustands erzeugen später Duplikate.
`--delete2` löscht nach der Umschaltung neue E-Mails vom Ziel.

Eine Migration, die „bis auf Sent Items weitgehend in Ordnung“ war, ist kein Zufall. Das Protokoll ließ gefährliche Möglichkeiten offen, und die Standardwerte schützten nicht davor.

Verbindungsparameter, die imapsync am Laufen halten

Bei großen Postfächern bricht oft die Verbindung ab, bevor ein Schreibvorgang endet. Lange APPEND-Vorgänge, langsame Exchange-Systeme und zustandsbehaftete Firewalls sind typische Ursachen. Abhilfe schaffen großzügigere Zeitlimits, Keepalives und ein Zustandszwischenspeicher, damit Wiederholungsläufe nicht von vorn beginnen.

Verwenden Sie beim ersten ernsthaften Lauf:

imapsync \
  --host1 imap.source.tld --user1 user@source.tld --passfile1 ./pass1 \
  --host2 imap.dest.tld   --user2 user@dest.tld   --passfile2 ./pass2 \
  --timeout 120 \
  --keepalive1 --keepalive2 \
  --usecache

Die Funktionen im Überblick:

Parameter	Warum er wichtig ist	Was ohne ihn schiefgeht
`--timeout 120`	Gibt langsamen Uploads und großen Anhängen genügend Zeit.	Nachrichten werden nach einem Socket-Timeout übersprungen.
`--keepalive1 --keepalive2`	Hält beide IMAP-Sitzungen während langer Pausen aktiv.	Firewalls oder Loadbalancer trennen die Sitzung.
`--usecache`	Speichert den Vergleichszustand lokal und beschleunigt Wiederholungen.	Fortsetzungen werden langsamer und prüfen alles erneut.

Der Cache ist wichtig, denn gute Migrationen verlaufen inkrementell. Nach dem Massentransfer werden Authentifizierungs- oder Zuordnungsfehler korrigiert und ein oder zwei Nachholläufe ausgeführt. Mit `--usecache` liest imapsync beide Seiten seltener erneut ein. Ohne ihn ist jeder weitere Lauf unnötig aufwendig.

Es gibt eine Einschränkung. Die offizielle Dokumentation warnt, dass `--usecache` in manchen Fällen nicht sicher mit kombinierten Größen- und Altersfiltern ist. Fügen Sie keine zufälligen Filter hinzu, nur weil sie effizient klingen. Halten Sie den ersten Lauf einfach.

Ordnerparameter gegen Panik wegen „fehlender Ordner“

Wenn Nutzer verlorene Ordner melden, sind die E-Mails oft noch vorhanden. Das Ziel hat den Quellpfad anders interpretiert oder einen lokalisierten Spezialordner nicht dem aktiven Gesendet-Ordner zugewiesen. Bei abweichenden Anbietern braucht imapsync eine ausdrückliche Übersetzung.

Die größten Fallen sind Hierarchietrennzeichen und Spezialordner.

Manche Server verwenden Punkte zur Verschachtelung, andere Schrägstriche. Besitzt die Quelle INBOX.Clients.ProjectA, während das Ziel INBOX/Clients/ProjectA erwartet, muss der Pfad beim Kopieren umgeschrieben werden.

imapsync \
  --host1 old.example.com --user1 user@old.example.com --passfile1 ./pass1 \
  --host2 imap.trekmail.net --user2 user@example.com --passfile2 ./pass2 \
  --regextrans2 's/\./\//g'

Auch der Gesendet-Ordner trägt je nach Anbieter andere Namen. Nutzer wollen lediglich ihre E-Mails in der aktiven Gesendet-Ansicht finden.

Quellordner	Zielordner	Geeigneter Parameter
`[Gmail]/Sent Mail`	`Sent Items`	`--regextrans2 's/^\[Gmail\]\/Sent Mail/Sent Items/'`
`Sent`	`Sent Items`	`--regextrans2 's/^Sent/Sent Items/'`
`Gesendete Elemente`	`Sent Items`	`--regextrans2 's/^Gesendete Elemente/Sent Items/'`

Bei üblichen Spezialordnern empfiehlt sich zunächst --automap. Bei unaufgeräumten, lokalisierten oder alten cPanel-Postfächern sind ausdrückliche Regex-Transformationen sicherer. TrekMail bietet außerdem Anleitungen zum Starten eines Imports im Dashboard und zur Vorbereitung beim Hinzufügen einer Domain.

Anschauliches Beispiel: Der Ordner verschwand nicht. Statt im erwarteten Gesendet-Ordner liegt er unter einem unverarbeiteten Archivnamen, den der Client nicht als „Gesendet“ erkennt. Dieselben Daten am falschen Ort erzeugen trotzdem dasselbe Supportticket.

imapsync drosseln, bevor Google oder Microsoft es tun

Für gehostete Mailanbieter kann imapsync wie missbräuchlicher Verkehr wirken. Schnelle APPEND- und FETCH-Folgen über viele Postfächer lösen Geschwindigkeitslimits, vorübergehende Sperren oder scheinbare Authentifizierungsfehler aus, hinter denen Kapazitätsgrenzen stehen. Langsam und stetig ist oft schneller als eine Blockierung.

Steuern Sie bei Google Workspace oder Microsoft 365 das Tempo:

imapsync \
  --host1 imap.gmail.com --user1 user@source.tld --passfile1 ./pass1 \
  --host2 imap.trekmail.net --user2 user@dest.tld --passfile2 ./pass2 \
  --maxbytespersecond 500000 \
  --maxmessagespersecond 2

Das reduziert Lastspitzen, die Schutzmechanismen auslösen, und schützt gemeinsam genutzte Systeme vor kurzen Folgen kleiner Nachrichten. Es betrifft alte cPanel-Systeme ebenso wie ausgelastete Office 365-Mandanten.

Die Werte sind Ausgangspunkte, keine unveränderlichen Regeln. Das passende Limit hängt von Postfachgröße, Parallelität und der Toleranz des Quellanbieters ab. Beginnt eine Migration gut und entwickelt später sporadische Fehler, reduzieren Sie zuerst das Tempo, bevor Sie ein falsches Passwort vermuten.

Hier wird der Unterschied zwischen altem und neuem Weg deutlich.

Alter Weg: jedes Postfach von Hand skripten, Drosselungswerte ausprobieren und Fehler um 2 Uhr nachts überwachen.

Neuer Weg: den integrierten serverseitigen Import kostenpflichtiger TrekMail-Tarife nutzen, das Ziel standardisieren und Nutzergebühren vermeiden. Agenturen mit vielen Domains ist weniger wichtig, ob ein Postfach zehn Minuten früher fertig ist. Sie wollen keine drei Tage lang Wiederholungsfehler untersuchen. Dazu passt dieser Leitfaden zum Multi-Domain-E-Mail-Hosting.

Authentifizierungsparameter für 2025-2026: Passwörter verlieren, OAuth gewinnt

Bei Google Workspace und Microsoft 365 kann einfache IMAP-Anmeldung mit Benutzername und Passwort nicht mehr vorausgesetzt werden. Laut Google unterstützen Workspace-Konten seit dem 1. Mai 2025 keine „weniger sicheren Apps“ mehr, die sich nur damit anmelden. Auch Microsoft verweist bei Exchange Online für IMAP-Clients auf OAuth.

Das verändert den imapsync-Aufruf. Unterstützt die Quelle XOAUTH2, wird statt des normalen Nutzerpassworts ein Zugriffstoken benötigt.

imapsync \
  --host1 outlook.office365.com \
  --user1 user@source.tld \
  --authmech1 XOAUTH2 \
  --oauthaccesstoken1 "ACCESS_TOKEN" \
  --host2 imap.trekmail.net \
  --user2 user@dest.tld --passfile2 ./pass2

Bei Google Workspace können App-Passwörter für einmalige Umzüge weiterhin praktisch sein, wenn die 2-Schritt-Bestätigung aktiviert ist. Bei Microsoft 365 ist der dokumentierte OAuth-Ablauf für ältere Protokolle richtig. Nimmt Ihr Skript weiterhin an, „richtiges Passwort bedeutet richtige Authentifizierung“, ist es überholt.

Maßgebliche Quellen: Googles Workspace-Hinweise zu weniger sicheren Apps und Microsofts OAuth-Anleitung für IMAP.

Integritätsparameter gegen übersprungene problematische E-Mails

Manche Nachrichten sind beschädigt. Auf alten Servern sind fehlende Message-ID-Kopfzeilen, fehlerhaftes MIME, riesige Anhänge und leere Inhalte normal. imapsync kann einige Probleme umgehen, wenn es entsprechend angewiesen wird.

Der erste hilfreiche Parameter ist --addheader. Laut Dokumentation fügt er eine erzeugte Message-Id-Kopfzeile hinzu, wenn sie fehlt. Das ist wichtig, weil imapsync anhand der Nachrichtenidentität erkennt, was bereits vorhanden ist.

Der zweite ist --maxsize. Wenn Ziel oder Richtlinie besonders große Nachrichten ablehnen, darf eine Ausnahme nicht den gesamten Auftrag blockieren.

imapsync \
  --host1 old.example.com --user1 user@old.example.com --passfile1 ./pass1 \
  --host2 imap.trekmail.net --user2 user@example.com --passfile2 ./pass2 \
  --addheader \
  --maxsize 35000000

Diese großen Nachrichten werden nicht verleugnet. Übertragen Sie zuerst die 99% und behandeln Sie Ausnahmen danach anhand einer kontrollierten Liste.

Bei parallelen Bereitstellungen gehört dazu ein sauberer Einrichtungsprozess. Der TrekMail-Leitfaden zum massenhaften Anlegen von E-Mail-Konten ist hilfreich, denn getrennte Tabellen für Postfächer, Passwörter und DNS verschärfen Migrationsprobleme.

Der gefährlichste imapsync-Parameter: --delete2

`--delete2` entfernt am Ziel Nachrichten, die an der Quelle fehlen. Für exakte Spiegelung klingt das nützlich. Zum falschen Zeitpunkt ausgeführt, löscht es nach der MX-Umschaltung jedoch gültige neue E-Mails.

Der Fehlerablauf:

Alte E-Mails werden vorab von der Quelle zum Ziel übertragen.
Der MX-Eintrag wird auf den neuen Anbieter umgestellt.
Neue E-Mails treffen am Ziel ein.
imapsync wird erneut mit --delete2 ausgeführt.
imapsync erkennt nur am Ziel vorhandene E-Mails und löscht sie, weil sie nie an der Quelle lagen.

Das ist kein Programmfehler, sondern genau der erteilte Auftrag.

Verwenden Sie `--delete2` nur in einem kontrollierten Spiegelungsszenario vor der Umschaltung, solange beide Seiten logisch an die alte Datenquelle gebunden sind. Nach der MX-Änderung gehört der Parameter nicht mehr in den Befehl. Empfängt das Ziel neue E-Mails, ist es dafür maßgeblich.

Wenn UIDs täuschen: Abgleich anhand von Kopfzeilen

IMAP-UIDs sind nur innerhalb ihres Serverzustands zuverlässig. RFC 3501 definiert UIDVALIDITY, weil UID-Annahmen nach Zustandsänderungen ungültig werden können. Wird ein Quellordner neu aufgebaut oder indiziert, hält imapsync später möglicherweise jede Nachricht für neu und dupliziert alles.

Dann hilft der kopfzeilenbasierte Abgleich:

imapsync \
  --host1 old.example.com --user1 user@old.example.com --passfile1 ./pass1 \
  --host2 imap.trekmail.net --user2 user@example.com --passfile2 ./pass2 \
  --useheader 'Message-Id'

Das ist langsamer als das Vertrauen auf Server-UIDs, aber bei instabilen, neu aufgebauten oder inkonsistenten Quellen sicherer. Laut offizieller Dokumentation lassen sich Duplikate oft mit --useheader "Message-Id" beheben.

Zur letzten Prüfung empfiehlt sich vor der DNS-Umschaltung ein Probelauf mit vorsichtigem Abgleich und danach ein kurzer Delta-Lauf, sobald Nutzer das alte System nicht mehr ändern.

Eine sichere imapsync-Befehlsvorlage

Ein sicherer Lauf benennt Verbindung, Zuordnungen, Ausschlüsse und Testmodus ausdrücklich. Beginnen Sie trocken, prüfen Sie das Ordnerverhalten und starten Sie erst dann die echte Übertragung. Ein erster Entwurf gehört nicht an produktive E-Mails.

imapsync \
  --host1 imap.gmail.com --user1 user@source.com --passfile1 ./pass1 \
  --host2 imap.trekmail.net --user2 user@dest.com --passfile2 ./pass2 \
  --timeout 120 --keepalive1 --keepalive2 \
  --usecache \
  --automap \
  --regextrans2 's/^\[Gmail\]\/Sent Mail/Sent Items/' \
  --exclude '^\[Gmail\]/All Mail' \
  --maxbytespersecond 500000 \
  --maxmessagespersecond 2 \
  --dry

Drei praktische Hinweise:

Verwenden Sie zuerst immer --dry.
Schließen Sie große, zunächst unnötige Archivordner aus.
Speichern Sie das Protokoll und versionieren Sie Befehlszeilen je Migrationsstapel.

Nach dem Umzug zu TrekMail verbinden sich Nutzer per Standard-IMAP mit imap.trekmail.net über Port 993. TrekMail unterstützt IMAP, nicht POP3. Das ist sinnvoll für synchronisierte Zustände auf mehreren Geräten.

Fazit: imapsync funktioniert als richtig betriebenes Migrationswerkzeug

imapsync bleibt für viele Umzüge die richtige Wahl, wenn es als zustandsbehaftete Migrationssoftware statt als simpler Kopierbefehl betrieben wird. Setzen Sie Zeitlimits und Keepalives, ordnen Sie Ordner bewusst zu, drosseln Sie bei Gegenwehr, nutzen Sie moderne Authentifizierung und halten Sie `--delete2` von E-Mails nach der Umschaltung fern. Bei zweifelhaftem UID-Zustand erzwingen Sie einen Kopfzeilenabgleich.

Für eine leichter verwaltbare Empfängerseite bietet TrekMail ein Ziel für mehrere Domains mit Pauschalpreisen, gemeinsam genutztem Speicher, integriertem serverseitigem Import in kostenpflichtigen Tarifen und ohne neue Nutzergebühr für jedes Postfach. Als Grundlage nach dem Umzug empfiehlt sich dieser Artikel über geschäftliche E-Mail.