Installing.de

🌐 English

Installation (gramps-connect-desktop)

gramps-connect-desktop ist die eigenständige Version von Gramps Connect: eine herunterladbare App, die das app/-Frontend und das Backend von gramps-web-api zusammen mit SQLite bündelt und komplett auf dem eigenen Rechner läuft. Es ist der einfachste Weg, Gramps Connect heute auszuprobieren, und eine echte Alternative zu Gramps Desktop für die tägliche Arbeit am eigenen Stammbaum — keine eingeschränkte Vorschau von irgendetwas anderem.

Es ist absichtlich für einen einzelnen Benutzer ausgelegt: es lauscht nur auf 127.0.0.1, sodass nichts davon über ein Netzwerk erreichbar ist, und es hat immer genau einen fest eingebauten Login, admin / admin. Wer eine ganze Familie in einen gemeinsamen Stammbaum einloggen oder die Live-Zusammenarbeits-Funktionen in Aktion sehen möchte, findet das stattdessen unter Bereitstellung — die eigenständige Version hat niemand sonst, dessen Änderungen man beim Erscheinen zusehen könnte.

Jeder aktuelle Download liegt beim neuesten Release. Alle beginnen mit einem leeren Stammbaum — die eigene Gramps-XML-Datei (.gramps) oder GEDCOM-Datei (.ged) über den Bildschirm Stammbäume → Importieren … der App importieren, sobald sie läuft.

Beim ersten Start wird ein kleines Datenverzeichnis im eigenen Home-Ordner angelegt (.gramps-connect-desktop), das diesen Stammbaum enthält; spätere Starts verwenden es weiter. Dieses Verzeichnis löschen, um wieder bei einem leeren Stand anzufangen. Dies sind unsignierte, reine x86_64-Builds, daher die unten beschriebenen Betriebssystem- Warnungen — kein Zeichen, dass etwas nicht stimmt.

Windows

1. gramps-connect-desktop-windows.zip vom neuesten Release herunterladen und entpacken (Rechtsklick → Alle extrahieren).
2. Den entpackten Ordner öffnen und gramps-connect-desktop.exe doppelklicken.
3. Windows zeigt vermutlich eine SmartScreen-Warnung („Windows hat den Computer geschützt“), weil dies keine signierte ausführbare Datei ist. Auf Weitere Informationen klicken, dann Trotzdem ausführen.
4. Ein Fenster öffnet sich automatisch und die App läuft. Anmelden als admin / admin.

macOS (Apple Silicon)

Für M1/M2/M3/M4-Macs.

1. gramps-connect-desktop-macos-arm64.zip vom neuesten Release herunterladen und entpacken (Doppelklick, oder Rechtsklick → Öffnen, je nach den eigenen Mac-Einstellungen), um gramps-connect-desktop.app zu erhalten.
2. gramps-connect-desktop.app doppelklicken. Dieser Build ist mit einer Developer-ID signiert und von Apple notariell beglaubigt, sollte sich also normal öffnen, ganz ohne Gatekeeper-Warnung. Erscheint trotzdem eine, siehe Fehlerbehebung unten.
3. Ein Fenster öffnet sich automatisch und die App läuft. Anmelden als admin / admin.

macOS (Intel)

Für ältere Intel-basierte Macs (vor Apple Silicon). Dieselben Schritte wie oben bei Apple Silicon, aber stattdessen gramps-connect-desktop-macos-intel.zip herunterladen.

Linux (.deb — Debian, Ubuntu und Derivate)

1. Die .deb-Datei (gramps-connect-desktop_*_amd64.deb) vom neuesten Release herunterladen.
2. Installieren: sudo apt install ./gramps-connect-desktop_*_amd64.deb (Installation aus einer lokalen Datei statt aus einem Repository, apt wird also vermutlich warnen, dass das Paket nicht signiert ist — erwartet, siehe Fehlerbehebung).
3. gramps-connect-desktop aus einem Terminal starten, oder „Gramps Connect Desktop“ im Anwendungsmenü suchen.
4. Dies öffnet sich in einem eigenen nativen Fenster, mit dem bereits auf dem System vorhandenen GTK3 + WebKit2 (auf Linux-Desktops üblich — viele Apps hängen bereits davon ab; keines der beiden wird von diesem Paket mitgeliefert). Fehlen sie auf dem System, öffnet sich stattdessen ein Browser-Tab (siehe Fehlerbehebung). Anmelden als admin / admin.
5. Zum Deinstallieren: sudo apt remove gramps-connect-desktop.

Linux (.rpm — Fedora, RHEL, AlmaLinux und Derivate)

1. Die .rpm-Datei (gramps-connect-desktop-*.x86_64.rpm) vom neuesten Release herunterladen.
2. Installieren: sudo dnf install ./gramps-connect-desktop-*.x86_64.rpm (auf einem System ohne dnf funktioniert auch sudo rpm -i gramps-connect-desktop-*.x86_64.rpm, nur ohne automatische Abhängigkeitsauflösung). Wie oben beim .deb bedeutet die Installation aus einer lokalen Datei, dass dnf/rpm vermutlich warnt, dass das Paket nicht signiert ist — erwartet.
3. gramps-connect-desktop aus einem Terminal starten, oder „Gramps Connect Desktop“ im Anwendungsmenü suchen.
4. Dies öffnet sich in einem eigenen nativen Fenster (oder weicht auf einen Browser-Tab aus) — genau wie oben beim .deb. Anmelden als admin / admin.
5. Zum Deinstallieren: sudo dnf remove gramps-connect-desktop.

Konfiguration

gramps-connect-desktop funktioniert ganz ohne Konfiguration. Der einzige optionale Regler ist ausgehende E-Mail: standardmäßig schlägt alles, was Mail versenden würde (Passwort zurücksetzen, E-Mail-Bestätigung, Benachrichtigung über neue Benutzer — obwohl es bei einer Einzelbenutzer-Version niemanden zu benachrichtigen gibt), einfach mit „Connection was refused“ fehl, da auf dem eigenen Rechner kein Mailserver dafür bereitsteht. Um diese E-Mails tatsächlich zu versenden, vor dem Start der App diese Umgebungsvariablen setzen:

Variable	Zweck
GRAMPSWEB_EMAIL_HOST	Hostname des SMTP-Servers
GRAMPSWEB_EMAIL_PORT	Port des SMTP-Servers (Standard 465)
GRAMPSWEB_EMAIL_HOST_USER	SMTP-Anmeldename
GRAMPSWEB_EMAIL_HOST_PASSWORD	SMTP-Anmeldepasswort
GRAMPSWEB_DEFAULT_FROM_EMAIL	„Von“-Adresse gesendeter E-Mails
GRAMPSWEB_EMAIL_USE_SSL	true/false — implizite TLS/SSL-Verbindung
GRAMPSWEB_EMAIL_USE_STARTTLS	true/false — einfache Verbindung, per STARTTLS aufgewertet
GRAMPSWEB_EMAIL_USE_TLS	true/false — älterer Alias; die beiden obigen bevorzugen (Standard true, d. h. implizites TLS)

Nur gesetzte Variablen wirken sich aus; alles Ungesetzte fällt auf den eigenen Standardwert von gramps-web-api für diese Option zurück. Zum Beispiel, um über Gmail mit einem App-Passwort zu versenden:

GRAMPSWEB_EMAIL_HOST=smtp.gmail.com \
GRAMPSWEB_EMAIL_PORT=587 \
GRAMPSWEB_EMAIL_HOST_USER=you@gmail.com \
GRAMPSWEB_EMAIL_HOST_PASSWORD=your-app-password \
GRAMPSWEB_EMAIL_USE_STARTTLS=true \
GRAMPSWEB_DEFAULT_FROM_EMAIL=you@gmail.com \
./gramps-connect-desktop

Aus einem Terminal gestartet, überspringt --browser das native Fenster unter macOS/Windows und öffnet immer stattdessen den eigenen Standardbrowser — derselbe Rückfall, den Linux immer verwendet (siehe Architektur), nur bewusst gewählt statt automatisch. Praktisch, wenn man lieber die eigenen Entwicklertools/ Erweiterungen des eigenen Browsers nutzen oder das native Webview ausschließen möchte, wenn etwas seltsam aussieht:

./gramps-connect-desktop --browser

Fehlerbehebung

• Windows SmartScreen („Windows hat den Computer geschützt“) — erwartet, da dieser Build nicht code-signiert ist. Auf Weitere Informationen → Trotzdem ausführen klicken.
• macOS Gatekeeper („kann nicht geöffnet werden, weil Apple die App nicht auf schädliche Software überprüfen kann“) — dieser Build ist mit einer Developer-ID signiert und von Apple notariell beglaubigt, das sollte also nicht passieren. Passiert es doch, zuerst versuchen, das Quarantäne-Flag von der gesamten .app auf einmal zu entfernen: xattr -cr gramps-connect-desktop.app (im Terminal ausführen, im Ordner, in den entpackt wurde). Bitte zusätzlich melden — es bedeutet wahrscheinlich, dass das Notarisierungs-Ticket den Download/das Entpacken nicht wie erwartet überstanden hat, oder dass der Build nicht korrekt notariell beglaubigt wurde.
• apt/dnf warnt, dass die .deb/.rpm-Datei nicht signiert ist, oder überspringt eine OpenPGP-Prüfung — erwartet. Diese Pakete werden von der eigenen CI dieses Repositorys gebaut, nicht in einem signierten Distributions-Repository veröffentlicht, die Installation aus einer lokalen Datei sieht also immer so aus; es bedeutet nicht, dass etwas nicht stimmt.
• dnf: command not found / rpm: command not found — die eigene Distribution basiert auf Debian/Ubuntu (oder liefert rpm sonst nicht mit), das .rpm-Paket ist also der falsche Download. Stattdessen die .deb-Datei herunterladen und mit sudo apt install ./gramps-connect-desktop_*_amd64.deb installieren (siehe den .deb-Abschnitt oben).
• Auf keiner Plattform erscheint ein Fenster oder Browser-Tab — die App versucht immer, automatisch eines zu öffnen, sobald ihr Server läuft; scheitert das irgendwie, http://127.0.0.1:5050 selbst öffnen. Läuft dort auch nichts, ist etwas vorher abgestürzt — die Terminal-Ausgabe prüfen (Windows: gramps-connect-desktop.exe aus einem cmd-/PowerShell-Fenster statt per Doppelklick starten, um sie zu sehen) auf eine Fehlermeldung, und in Betracht ziehen, mit dieser Ausgabe ein Issue zu eröffnen.
• Die App startet nicht / Port bereits belegt — es kann immer nur eine Instanz gleichzeitig laufen (fest auf 127.0.0.1:5050 eingestellt). Jede andere laufende Kopie schließen, oder was auch immer sonst Port 5050 belegt, und erneut versuchen.
• Ein Browser-Tab öffnet sich statt eines nativen Fensters — die App versucht immer zuerst ein natives Fenster und weicht automatisch aus, wenn das nicht geht: WebView2 unter Windows (auf Windows 10/11 standardmäßig vorhanden) oder WKWebView unter macOS (immer vorhanden) konnte nicht erreicht werden, oder unter Linux sind GTK3 + WebKit2 nicht systemweit installiert (python3-gi, gir1.2-gtk-3.0 und gir1.2-webkit2-4.1, oder die Entsprechungen der eigenen Distribution installieren und neu starten, um stattdessen ein natives Fenster zu bekommen). Die App funktioniert so oder so vollständig im Browser-Tab — das betrifft nur die Darstellung, nicht die Funktionalität.
• Von einem leeren Stammbaum neu anfangen — den Ordner .gramps-connect-desktop im eigenen Home-Verzeichnis löschen, dann neu starten.
• Auf der Suche nach einer echten Mehrbenutzer-Bereitstellung statt dieser lokalen Einzelbenutzer-Version? Siehe Bereitstellung.

Siehe auch FAQ für Fragen zur Datensicherheit und dazu, wie sich gramps-connect-desktop mit Gramps Desktop und der Server-Bereitstellung vergleicht.