Dokumentation / Fehlerbehebung / Cloud-Synchronisierung

Fehlerbehebung

Bei der Cloud-Synchronisierung geht es um mehr als „Internet da oder weg“.

Contextify synchronisiert mit einem konfigurierten Ziel: der gehosteten Contextify Cloud oder deinem selbst gehosteten Server. Ist dieses Ziel nicht erreichbar, kann die App offline sein, obwohl andere Websites funktionieren.

Statusanzeigen

Status Bedeutung Vorgehen
Healthy Die Cloud ist für den zuletzt geprüften Stand aktuell. Keine Aktion erforderlich.
Syncing Contextify lädt aktuelle Änderungen hoch oder Änderungen vom Server herunter. Lass den Vorgang abschließen. Umfangreiche nachholende Synchronisierungen können nach der lokalen Erfassung Zeit brauchen.
Waiting Die Transkripterfassung muss abgeschlossen sein, bevor die Synchronisierung beginnt. Warte, bis die lokale Indexierung abgeschlossen ist. Siehe Erfassung und Synchronisierung.
Deferred Die Synchronisierung pausiert, während die Transkripterfassung aktiv ist. Contextify versucht die Synchronisierung automatisch erneut, oder du kannst später manuell synchronisieren.
Offline Das konfigurierte Cloud-Ziel war nicht erreichbar. Prüfe Ziel-URL, DNS, VPN und Serverzustand.
Attention needed oder Error Der letzte Synchronisierungsversuch ist fehlgeschlagen oder der Fortschritt muss geprüft werden. Nutze Retry und Copy Diagnostics unter Settings → Cloud.

Beginne unter Settings → Cloud

  1. Lies den letzten Fehler

    Das Fehlerfeld zeigt den letzten lokalen oder serverseitigen Synchronisierungsfehler. Es zeigt außerdem das konfigurierte Ziel und den Zeitpunkt der letzten Statusprüfung.

  2. Klicke auf Retry

    Retry lädt die gespeicherte Cloud-Konfiguration erneut, startet die Synchronisierung und aktualisiert Status und Kontodetails.

  3. Diagnosedaten kopieren

    Copy Diagnostics enthält Anbieter, Server, Gerätename, Status, Zeitpunkt der letzten Prüfung sowie bereinigte Status- und Kontofehler.

Prüfungen für die gehostete Cloud

Die gehostete Cloud nutzt cloud.contextify.sh. Wenn andere Websites funktionieren, die gehostete Cloud aber nicht, gehe nicht pauschal von einem Internetausfall aus. Prüfe das konkrete Ziel. 

curl -i https://cloud.contextify.sh/api/v1/health
contextify cloud status --json

DNS-Fehler bei der gehosteten Cloud können sich bei einem erneuten Versuch auflösen. Dauerhafte Fehler deuten meist auf lokale DNS-Einstellungen, ein blockiertes Netzwerk oder eine Dienststörung hin.

Prüfungen für Self-Hosted

Die Self-Hosted-Synchronisierung hängt von der exakt gespeicherten Server-URL ab. Prüfe Schema, Hostname, Port, VPN und den Namen im TLS-Zertifikat. 

curl -i https://your-server.example.com/api/v1/health
contextify cloud status --json
contextify cloud sync --json

Bei Tailscale-Servern unter .ts.net bedeutet ein DNS-Fehler oft, dass der MagicDNS-Resolver unter macOS nicht richtig funktioniert. Möglicherweise musst du Tailscale neu verbinden oder seine VPN-Konfiguration zurücksetzen.

Anleitung zu TLS, VPN und Tailscale lesen

So kann der Support am schnellsten helfen

Copy Diagnostics ist dafür ausgelegt, Geheimnisse auszulassen. Prüfe die Ausgabe trotzdem vor dem Senden. Füge die Diagnosedaten und die von Geheimnissen bereinigte Server-URL bei und gib an, ob das Ziel gehostet oder selbst gehostet ist und ob curl /api/v1/health erreichen kann.

Erwähne auch, ob der Mac beim Auftreten des Synchronisierungsproblems noch einen umfangreichen lokalen Verlauf indexiert oder verarbeitet hat.

Sende keine ungekürzten API-Schlüssel, Browser-Cookies, Magic Links, OTP-Codes oder Setup-Tokens.

Zuletzt aktualisiert: 6. Mai 2026