Handbuch · Sync und Server
Sync
Wie tagwerk deine Notizen auf mehreren Geräten hält - mit dem eingebauten WebDAV-Sync oder einem eigenen Ordner - und was zu tun ist, wenn ein Sync stockt oder zwei Geräte sich widersprechen.
Zwei Wege zum Sync
tagwerk hat keinen eigenen Server. Deine Notizen kommen auf einem von zwei Wegen auf deine anderen Geräte:
| Eingebauter Sync | Ein eigener Ordner | |
|---|---|---|
| Wie | Die App spricht WebDAV mit deinem Server: Nextcloud, ownCloud, Synology, jede WebDAV-Adresse. | Die Notizen liegen in einem Ordner, den ein anderes Programm trägt: Syncthing, die Nextcloud-App, ein Desktop-Sync-Client. |
| Wo einrichten | Einstellungen → Sync → Sync einrichten... | Einstellungen → Ablage → Ordner wählen..., dann das andere Programm für diesen Ordner einrichten. |
| Konflikte | Nach den Regeln von tagwerk, siehe Konflikte. | Nach den Regeln des anderen Programms; tagwerk erkennt dessen Konfliktkopien. |
| Kosten | Teil von tagwerk Pro. | Frei, und das bleibt so. |
Unter Android öffnet Ordner wählen... die Ordnerauswahl des Systems, unter Windows und Linux einen gewöhnlichen Ordnerdialog. Der Guide zum eigenen Sync geht beide Wege mit ihren Gründen durch.
Nimm je Profil einen der beiden Wege. Ein Ordner, den schon der Nextcloud-Client trägt, braucht nicht zusätzlich den eingebauten Sync in denselben Server-Ordner.
Was der eingebaute Sync überträgt
Vier Arten von Dateien, jede nach einer eigenen Regel:
| Datei | Wo sie liegt | Regel |
|---|---|---|
| Tagesnotizen | 2026/10/2026-10-28.md | In beide Richtungen. Uploads sind bedingt, ein Gerät kann also keine Fassung überschreiben, die es nie gesehen hat. |
| Tagesvorlagen | templates/ | In beide Richtungen, wie die Notizen. Eine entfernte Vorlage verschwindet auch auf den anderen Geräten. |
| Tag-Farben | settings/tagwerk.colors | In beide Richtungen, wie die Notizen. Wer alle Farben entfernt, entfernt die Datei, und auch das wird übertragen. |
| Lizenz | settings/tagwerk.license | Hochgeladen nur, wenn der Server keine hat, heruntergeladen nur, wenn dieses Gerät keine hat. Nie ersetzt, nie gelöscht. |
Was der eingebaute Sync nie tut:
- Er gibt keinen gelöschten Tag weiter. Eine auf einem Gerät gelöschte Notiz bleibt auf dem Server und auf jedem anderen Gerät, und der nächste Sync bringt sie auf dieses zurück. Ein Aufräumen auf einem Gerät kann kein Jahr Notizen mitnehmen. Soll ein Tag überall leer sein, leere ihn in der App: Ein leerer Tag wird übertragen wie jede andere Änderung.
- Er nimmt die Lizenz nicht weg. Entfernst du die Lizenz auf einem Gerät, bleibt die Kopie auf dem Server und auf allen anderen Geräten. Hat das Gerät Pro auch auf anderem Weg - durch einen Kauf über Google Play oder unter Linux -, bringt sein nächster Sync die Datei zurück; sonst endet mit der Lizenz auch der eingebaute Sync auf diesem Gerät. Soll sie überall weg, lösche sie im Ordner auf dem Server.
- Er rührt keine anderen Dateien an. Gelesen und geschrieben werden nur die Dateien oben. Alles andere im Ordner auf dem Server oder in deinem Notizordner bleibt, wo es ist.
- Er lädt keine Konfliktkopien hoch. Eine Konfliktkopie bleibt auf dem Gerät, das sie angelegt hat, bis du entscheidest (siehe Konflikte).
- Er lädt die unveränderte Willkommensnotiz nicht hoch. Sonst zeigte ein zweites Gerät das Tutorial, das ein erstes geschrieben hat. Sobald du sie bearbeitet hast, wandert sie wie jede Notiz.
Ersetzt der Sync eine Notiz auf diesem Gerät durch die Fassung vom Server, kommt der Stand davor zuerst in den Verlauf dieses Tages.
Bevor du anfängst
Du brauchst:
- die Adresse deines WebDAV-Servers, zum Beispiel
https://cloud.example.org. Bei Nextcloud und ownCloud genügt die normale Adresse des Servers; - einen Benutzernamen und ein Passwort. Mit Zwei-Faktor-Anmeldung am Konto ein App-Passwort statt des Konto-Passworts - oder bei Nextcloud die Anmeldung im Browser;
- Pro unter Android und Windows (siehe oben).
Welche Adresse ein bestimmter Server will und was er können muss, steht unter Sync-Server.
Einrichten
Öffne Einstellungen → Sync und tippe auf Sync einrichten.... Der Assistent hat drei Schritte; der Zähler im Titel zeigt, wo du bist. Vor dem letzten Schritt wird nichts gespeichert: Abbrechen lässt eine bestehende Einrichtung jederzeit, wie sie war.
Schritt 1: Server und Anmeldung
- Trage die Server-Adresse ein. Fehlt
https://, wird es ergänzt. - Trage Benutzername und Passwort ein. Unter dem Passwort erinnert der Assistent: Mit Zwei-Faktor-Anmeldung ein App-Passwort.
- Tippe auf Weiter. Der Assistent prüft die Verbindung bis zur WebDAV-Stufe und zeigt jede Stufe, während sie läuft.
Schritt 2: der Notizordner
Der Assistent listet die Ordner auf dem Server, beginnend beim obersten Ordner deines Kontos.
- Tippe auf einen Ordner, um ihn zu öffnen, auf Nach oben, um eine Ebene zurückzugehen.
- Für einen neuen Ordner trägst du seinen Namen in Neuer Ordner ein und tippst daneben auf Ordner anlegen.
- Diesen Ordner verwenden nimmt den Ordner, in dem du gerade bist. Deine Notizen kommen darunter, nach Jahr und Monat abgelegt.
Ein mit dir geteilter Ordner erscheint erst, wenn dein Konto die Freigabe angenommen hat - und dann in dem Ordner, in den dieses Konto empfangene Freigaben legt, nicht ganz oben.
Schritt 3: die vollständige Prüfung
Der Assistent läuft alle sechs Stufen noch einmal durch, jetzt mit einem Schreibtest im gewählten Ordner. Sind alle Stufen grün, tippe auf Fertig. Das Passwort kommt in den Anmeldespeicher des Geräts, nie in eine Datei, und der erste Sync beginnt sofort.
Findet der erste Sync Tage, die es auf diesem Gerät und auf dem Server mit unterschiedlichem Text gibt, überschreibt er keinen davon: Jeder wird zu einem Konflikt, den du klärst (siehe Konflikte).
Bei Nextcloud anmelden
Für Nextcloud bietet der Assistent in Schritt 1 einen zweiten Weg: Im Browser anmelden (Nextcloud).
- Trage die Server-Adresse ein.
- Tippe auf Im Browser anmelden (Nextcloud). Dein Browser öffnet die Anmeldeseite deines Servers, wo dein Passwortmanager und dein zweiter Faktor wie gewohnt funktionieren.
- Bestätige dort. Der Assistent wartet mit Bestätige die Anmeldung im Browser. Hast du die Seite versehentlich geschlossen, bringt Anmeldeseite erneut öffnen sie zurück.
Dein Server gibt tagwerk dann ein eigenes App-Passwort. Dein Konto-Passwort sieht die App nie. Die Verbindung erscheint in den Sicherheitseinstellungen deiner Nextcloud, wo du sie widerrufen kannst.
Bietet der Server das nicht an, sagt der Assistent Dieser Server bietet die Browser-Anmeldung nicht an - nutze Benutzername und Passwort.
Ohne Browser-Anmeldung - bei ownCloud oder einem Konto mit Zwei-Faktor-Anmeldung - legst du in der Weboberfläche des Servers ein App-Passwort an (Nextcloud und ownCloud: Einstellungen → Sicherheit → Geräte & Sitzungen) und trägst es als Passwort ein.
Wann er läuft
| Anlass | Was passiert |
|---|---|
| Du änderst eine Notiz | Etwa zehn Sekunden nach der letzten Änderung beginnt ein Sync, ein Schwung Tippen wird also ein Upload. |
| Die App startet | Ein Sync. |
| Du kehrst zur App zurück, und eine Notiz wurde inzwischen in einer anderen App geändert | Wie eine eigene Änderung: ein Sync etwa zehn Sekunden später. |
| Du wechselst das Profil | Ein Sync für das neue Profil beginnt sofort; einer, der noch für das alte läuft, wird beendet. |
| Du tippst auf die Wolke in der Werkzeugleiste oder auf Jetzt synchronisieren in den Einstellungen | Ein Sync beginnt sofort. |
| Nach Änderungen suchen | Solange die App offen ist, fragt sie den Server nach einem Takt: Aus, 5, 15, 30 oder 60 Minuten. Voreingestellt sind 15 Minuten. |
| Im Hintergrund synchronisieren (Android) | Bei geschlossener App: Aus, 15 oder 30 Minuten, 1, 3 oder 6 Stunden. Voreingestellt ist 1 Stunde. |
| Die App schließt oder geht in den Hintergrund | Noch wartende Änderungen werden gesendet, bis zu acht Sekunden lang. |
| Du änderst bei geschlossener App eine Aufgabe auf einem Android-Widget | Etwa eine Minute später ein Sync, sobald Android es zulässt - auch wenn Im Hintergrund synchronisieren aus ist. |
Nach Änderungen suchen stellst du je Profil unter Einstellungen → Sync ein; es erscheint, sobald der Sync eingerichtet ist. Eine Suche, die nichts findet, lässt die Wolke oben in Ruhe.
Im Hintergrund synchronisieren gibt es nur unter Android, unter Einstellungen → Startbildschirm & System. Es gilt einmal je Gerät und synchronisiert das Profil, das beim Lauf geöffnet ist. Den genauen Zeitpunkt legt Android fest und verschiebt ihn, um Akku zu sparen. Was dabei herunterkommt, steht sofort auf den Widgets. Unter Windows und Linux synchronisiert bei geschlossener App nichts.
Ein Fehler, der von selbst vergehen kann - kein Netz, ein Server, der nicht antwortet, eine Zeitüberschreitung, ein Serverfehler -, wird nach 20 Sekunden, 90 Sekunden und 5 Minuten erneut versucht, bevor er gemeldet wird. Ein abgelehntes Passwort oder ein fehlender Ordner wird sofort gemeldet, weil ein neuer Versuch daran nichts ändert.
Der Verbindungstest
Verbindung testen unter Einstellungen → Sync läuft dieselbe Prüfung wie der Assistent: sechs Stufen nacheinander. Er hält bei der ersten an, die scheitert, und nennt die Ursache statt "Sync fehlgeschlagen".
| Stufe | Was sie prüft |
|---|---|
| Netzwerk vorhanden | Das Gerät hat eine Netzwerkverbindung. |
| Servername auflösbar | Die Adresse ist gültig, und ihr Name lässt sich auflösen. |
| Verbindung und Verschlüsselung | Der Server antwortet auf seinem Port, und sein Zertifikat gilt für diesen Namen. |
| Anmeldung akzeptiert | Der Server nimmt Benutzername und Passwort an, und tagwerk findet seine WebDAV-Adresse. |
| WebDAV und Notizordner | Die Adresse spricht WebDAV, und der Notizordner existiert oder lässt sich anlegen. |
| Schreibtest | Eine Testdatei lässt sich in den Notizordner schreiben und wieder entfernen. |
Zu jedem Fehler gehört ein Satz, was zu tun ist. Die Ursachen je Stufe und wie die Administration sie behebt, stehen unter Sync-Server.
Konflikte
Jeder Upload trägt die Fassung, von der das Gerät ausging; der Server lehnt also ein Schreiben ab, das auf etwas Neuerem landen würde. Haben wirklich beide Seiten denselben Tag geändert, geht nichts verloren: Die Fassung dieses Geräts behält die Datei, die andere wird daneben geschrieben.
2026/10/2026-10-28.md
2026/10/2026-10-28.sync-conflict-tagwerk.md
Ein zweiter Konflikt am selben Tag bekommt -2, dann -3. Dasselbe passiert ganz ohne Sync: Schreibt ein anderer Editor oder ein Sync-Client den Tag, den tagwerk offen hat, bleibt dessen Fassung daneben liegen.
Ein Tag, der zweimal im Ordner liegt - 2026-10-28.md lose im Notizordner und 2026/10/2026-10-28.md -, wird aus der Datei unter seinem Jahr gelesen. Steht in der losen etwas anderes, wird sie genauso angeboten, als andere Fassung dieses Tages.
Kein Konflikt ist ein Tag, dessen Fassung auf diesem Gerät leer ist, oder einer, bei dem der Server einen früheren Stand des eigenen Textes dieses Geräts hält. Dann wird einfach die neuere Seite genommen.
Wo Konflikte erscheinen
- an der Wolke in der Werkzeugleiste: Konflikte offen: und die Anzahl;
- über der Notiz eines betroffenen Tages: Diesen Tag gibt es doppelt. mit Fassungen vergleichen;
- unter Einstellungen → Ablage: Einen Tag gibt es doppelt - hier und woanders geändert. mit Ansehen.
Einen Konflikt klären
Das Blatt Tage, die es doppelt gibt listet jede Kopie. Wähle eine, und beide Fassungen stehen als eine Liste da: Zeilen, die beide Fassungen haben, sind schon drin, und jede Zeile, die nur eine von beiden hat, trägt ein Kästchen zum Abhaken.
| Wahl | Ergebnis |
|---|---|
| Zeilen abhaken, dann Auswahl übernehmen | Der Tag enthält die gemeinsamen und die abgehakten Zeilen. Alles, Alle aus der jetzigen Fassung und Alle aus der Kopie setzen die Haken auf einmal. |
| Beide behalten | Die Kopie wird unter die jetzige Fassung gehängt, nach der Zeile --- Die andere Fassung ---. Nicht für Vorlagen. |
| Jetzige Fassung behalten | Die Datei bleibt, wie sie ist; die Kopie wird gelöscht. |
| Kopie übernehmen | Die Kopie ersetzt die jetzige Fassung. |
Die jetzige Fassung ist das, was jetzt in der Datei des Tages steht; die Kopie zeigt, wann sie entstanden ist. Beim Entstehen der Kopie ist die jetzige Fassung die dieses Geräts. Holt ein späterer Sync eine neuere Fassung des Tages herunter, ist die jetzige Fassung die vom Server, und das Blatt sagt das; was dieses Gerät vorher hatte, steht im Verlauf des Tages. Eine Kopie, deren Zeilen der heruntergeladene Tag alle schon enthält, entfernt der Sync, weil es nichts mehr zu entscheiden gibt.
Hat dieses Gerät für den Tag nichts, heißt Jetzige Fassung behalten stattdessen Kopie verwerfen, weil es genau das tut. Bevor eine Wahl die jetzige Fassung überschreibt, hebt der Verlauf des Tages sie auf. Die Konfliktkopie einer Vorlage wird in die Vorlage zurückgeschrieben, nie in einen Tag.
Fehler beim Sync
Die meisten Fehler halten den Verbindungstest an einer Stufe an (siehe oben). Einige findet erst ein Sync, der schon eine Weile läuft:
| Meldung | Was sie bedeutet | Was zu tun ist |
|---|---|---|
| Lesen klappt, aber Schreiben ist nicht erlaubt. | Der Ordner ist für dieses Konto schreibgeschützt, typisch für eine Freigabe ohne Bearbeiten-Recht. Downloads kommen weiter an. | Um Schreibzugriff bitten oder einen anderen Ordner wählen. Deine Notizen bleiben auf dem Gerät und gehen hoch, sobald Schreiben klappt. |
| Der Speicherplatz auf dem Server ist voll. | Der Server hat den Upload mangels Platz abgelehnt. | Platz schaffen oder die Administration bitten, das Kontingent zu erhöhen. |
| Die Anmeldung klappt, aber der Server lässt sie nicht an die Dateien. | Das Konto sieht keinen einzigen Ordner und darf keinen anlegen, während die Weboberfläche Ordner zeigt. | Passwort neu setzen und neu anmelden; prüfen, ob das App-Passwort auf die Dateien zugreifen darf. |
| Eine Notiz auf diesem Gerät konnte nicht gelesen werden. | Ein anderes Programm hält die Datei offen. | Nichts; die Notiz folgt beim nächsten Lauf. |
| Der Notizordner auf diesem Gerät ist nicht erreichbar. | Das Laufwerk ist nicht verbunden, der Ordner ist weg, oder die App darf ihn nicht mehr öffnen. Synchronisiert wurde nichts. | Laufwerk verbinden oder den Ordner neu wählen. |
| Das App-Passwort konnte nicht gespeichert werden. | Der Anmeldespeicher des Geräts hat das Passwort abgelehnt. | Schlüsselbund entsperren und den Assistenten erneut abschließen. Im Linux-Snap einmal sudo snap connect tagwerk:password-manager-service ausführen. |
| Der Server hat die Anfrage weitergeleitet, und dort wurde sie abgelehnt. | Die Adresse leitet auf eine andere weiter, meist http:// auf https://, und die Anmeldung geht dabei verloren. | Die Adresse eintragen, die die Meldung zeigt. |
Servertempo
Einstellungen → Hilfe → Servertempo zeigt, wie lange dein Server braucht, gemessen an jeder Anfrage, die der Sync stellt. Das hilft, wenn ein Sync langsam wirkt und du wissen willst, warum.
- Server - Adresse, Konto, Gemessene Anfragen und Seit. Sind mehrere Server gemessen, wechseln Schaltflächen zwischen ihnen.
- Nach Vorgang - je eine Zeile für Verbinden, Ordner lesen, Herunterladen, Hochladen, Ordner anlegen und Löschen, mit Anzahl, Erste, Danach, 95. Perzentil, Langsamste und Fehlgeschlagen. Erste ist die erste Anfrage ihrer Art in einem Sync; ein großer Abstand zu Danach deutet auf einen Server, der langsam anläuft, nicht auf einen generell langsamen.
- Ein Diagramm der letzten Anfragen mit logarithmischer Skala, ein Balken je Anfrage, fehlgeschlagene in eigener Farbe.
- Für deinen Hoster - dieselben Zahlen als englischer Klartext. Kopieren legt sie für eine Support-Anfrage in die Zwischenablage; Messwerte löschen beginnt von vorn.
Die Messwerte bleiben auf diesem Gerät. Es wird nichts verschickt.
Profile
Jedes Profil hat einen eigenen Sync: Server, Konto, Ordner, Passwort und Nach Änderungen suchen. Die Nextcloud des Arbeitsprofils und der Server des privaten Profils sehen nie die Notizen oder Zugangsdaten des anderen. Einstellungen → Sync gehört immer zum geöffneten Profil; bei mehr als einem Profil nennt die Überschrift darüber dieses Profil.
Nur Im Hintergrund synchronisieren unter Android gilt einmal je Gerät; es synchronisiert das Profil, das beim Lauf geöffnet ist.
Ohne den eingebauten Sync
Lege deine Notizen in einen eigenen Ordner (Einstellungen → Ablage → Ordner wählen...) und lass ein anderes Programm diesen Ordner tragen. Für die Notizen funktioniert das so gut wie der eingebaute Sync. Zwei Unterschiede:
- Konflikte folgen den Regeln des anderen Programms. tagwerk erkennt die Konfliktkopien von Syncthing, Nextcloud und Dropbox und listet sie wie die eigenen unter Tage, die es doppelt gibt.
- Die Lizenz reist mit dem Ordner.
settings/tagwerk.licenseliegt im Notizordner, also hat jedes Gerät an diesem Ordner Pro aus einem Kauf.
Ein Gerät, das noch kein Pro hat, kann seine Lizenz nicht über den eingebauten Sync holen. Es bekommt sie über einen Ordner, den ein anderes Programm synchronisiert, über Lizenz importieren im Bereich tagwerk Pro der Einstellungen oder aus der Kauf-Mail.
Was ein Server für beide Wege braucht und wie du es prüfst, steht unter Sync-Server.