Installing.nl

🌐 English · Deutsch · Español · Français · 简体中文

Installeren (gramps-connect-desktop)

gramps-connect-desktop is de zelfstandige versie van Gramps Connect: één downloadbare app die de frontend app/ en de backend van gramps-web-api samen met SQLite bundelt, en volledig op uw eigen computer draait. Het is vandaag de eenvoudigste manier om Gramps Connect uit te proberen, en een echt alternatief voor Gramps Desktop voor het dagelijkse werk aan uw eigen stamboom — geen beperkte voorproef van iets anders.

Het is bewust voor één gebruiker: het luistert alleen op 127.0.0.1, dus niets ervan is via een netwerk bereikbaar, en er is altijd precies één hardgecodeerde login, admin / admin. Als u een hele familie op één gedeelde stamboom wilt laten inloggen, of de functies voor live samenwerken in actie wilt zien, zie dan in plaats daarvan Implementeren — in de zelfstandige versie zijn er geen bewerkingen van anderen om te zien verschijnen.

Alle actuele downloads staan bij de nieuwste release. Ze beginnen allemaal met een lege stamboom — importeer uw eigen Gramps XML-bestand (.gramps) of GEDCOM-bestand (.ged) via het scherm Stambomen → Importeren... van de app zelf zodra die draait.

Bij de eerste keer starten wordt een kleine gegevensmap in uw thuismap aangemaakt (.gramps-connect-desktop) met die stamboom; latere keren wordt die hergebruikt. Verwijder die map om terug te gaan naar een lege lei. Dit zijn niet-ondertekende builds, alleen voor x86_64, vandaar de waarschuwingen van het besturingssysteem die hieronder worden beschreven — geen teken dat er iets mis is.

Windows

1. Download gramps-connect-desktop-windows.zip van de nieuwste release en pak het uit (rechtsklik → Alles uitpakken).
2. Open de uitgepakte map en dubbelklik op gramps-connect-desktop.exe.
3. Windows toont waarschijnlijk een SmartScreen-waarschuwing ("Windows heeft uw pc beschermd") omdat dit geen ondertekend programma is. Klik op Meer informatie en daarna op Toch uitvoeren.
4. Er opent automatisch een venster waarin de app draait. Log in als admin / admin.

macOS (Apple Silicon)

Voor Macs met M1/M2/M3/M4.

1. Download gramps-connect-desktop-macos-arm64.zip van de nieuwste release en pak het uit (dubbelklik, of rechtsklik → Open, afhankelijk van de instellingen van uw Mac) om gramps-connect-desktop.app te krijgen.
2. Dubbelklik op gramps-connect-desktop.app. Deze build is ondertekend met een Developer ID en door Apple genotariseerd, dus hij zou gewoon moeten openen zonder enige Gatekeeper-waarschuwing. Als u er toch een ziet, zie dan Problemen oplossen hieronder.
3. Er opent automatisch een venster waarin de app draait. Log in als admin / admin.

macOS (Intel)

Voor oudere Macs met Intel-processor (van vóór Apple Silicon). Dezelfde stappen als bij Apple Silicon hierboven, maar download in plaats daarvan gramps-connect-desktop-macos-intel.zip.

Linux (.deb — Debian, Ubuntu en afgeleiden)

1. Download het .deb-bestand (gramps-connect-desktop_*_amd64.deb) van de nieuwste release.
2. Installeer het: sudo apt install ./gramps-connect-desktop_*_amd64.deb (u installeert vanuit een lokaal bestand in plaats van een repository, dus apt waarschuwt waarschijnlijk dat het pakket niet is ondertekend — dat is te verwachten, zie Problemen oplossen).
3. Start gramps-connect-desktop vanuit een terminal, of zoek "Gramps Connect Desktop" in uw toepassingenmenu.
4. Het opent in een eigen native venster, met GTK3 + WebKit2 die al op uw systeem staan (gebruikelijk op Linux-desktops — veel apps zijn er al van afhankelijk; geen van beide wordt door dit pakket meegeleverd). Als uw systeem ze niet heeft, opent het in plaats daarvan in een browsertabblad (zie Problemen oplossen). Log in als admin / admin.
5. Verwijderen: sudo apt remove gramps-connect-desktop.

Linux (.rpm — Fedora, RHEL, AlmaLinux en afgeleiden)

1. Download het .rpm-bestand (gramps-connect-desktop-*.x86_64.rpm) van de nieuwste release.
2. Installeer het: sudo dnf install ./gramps-connect-desktop-*.x86_64.rpm (op een systeem zonder dnf werkt sudo rpm -i gramps-connect-desktop-*.x86_64.rpm ook, alleen zonder automatische afhandeling van afhankelijkheden). Net als bij het .deb hierboven betekent installeren vanuit een lokaal bestand dat dnf/rpm waarschijnlijk waarschuwt dat het pakket niet is ondertekend — te verwachten.
3. Start gramps-connect-desktop vanuit een terminal, of zoek "Gramps Connect Desktop" in uw toepassingenmenu.
4. Het opent in een eigen native venster (of valt terug op een browsertabblad) — net als bij het .deb hierboven. Log in als admin / admin.
5. Verwijderen: sudo dnf remove gramps-connect-desktop.

Configuratie

gramps-connect-desktop werkt helemaal zonder configuratie. De enige optionele instelling is uitgaande e-mail: standaard mislukt alles wat e-mail zou versturen (wachtwoord opnieuw instellen, e-mailbevestiging, melding van een nieuwe gebruiker — niet dat er iemand te melden valt bij een versie voor één gebruiker) gewoon met "Connection was refused", omdat er op uw computer geen mailserver is om mee te praten. Om die e-mails echt te versturen, stelt u deze omgevingsvariabelen in voordat u de app start:

Variabele	Doel
GRAMPSWEB_EMAIL_HOST	Hostnaam van de SMTP-server
GRAMPSWEB_EMAIL_PORT	Poort van de SMTP-server (standaard 465)
GRAMPSWEB_EMAIL_HOST_USER	Gebruikersnaam voor de SMTP-login
GRAMPSWEB_EMAIL_HOST_PASSWORD	Wachtwoord voor de SMTP-login
GRAMPSWEB_DEFAULT_FROM_EMAIL	Afzenderadres ("From") van verstuurde e-mails
GRAMPSWEB_EMAIL_USE_SSL	true/false — impliciete TLS/SSL-verbinding
GRAMPSWEB_EMAIL_USE_STARTTLS	true/false — gewone verbinding, opgewaardeerd via STARTTLS
GRAMPSWEB_EMAIL_USE_TLS	true/false — oudere alias; gebruik bij voorkeur de twee hierboven (standaard true, d.w.z. impliciete TLS)

Alleen de variabelen die u instelt hebben effect; alles wat niet is ingesteld, valt terug op de eigen standaardwaarde van gramps-web-api voor die optie. Bijvoorbeeld om via Gmail te versturen met een app-wachtwoord:

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

Vanuit een terminal gestart, slaat --browser het native venster op macOS/Windows over en opent de app altijd in uw standaardbrowser — dezelfde terugvaloptie die Linux altijd gebruikt (zie Architectuur), alleen bewust gekozen in plaats van automatisch. Handig als u liever de devtools/extensies van uw eigen browser gebruikt, of de native webview wilt uitsluiten als er iets mis lijkt:

./gramps-connect-desktop --browser

Problemen oplossen

• Windows SmartScreen ("Windows heeft uw pc beschermd") — te verwachten, omdat deze build geen codeondertekening heeft. Klik op Meer informatie → Toch uitvoeren.
• macOS Gatekeeper ("kan niet worden geopend omdat Apple het niet kan controleren op schadelijke software") — deze build is ondertekend met een Developer ID en door Apple genotariseerd, dus dit zou niet moeten gebeuren. Als het toch gebeurt, probeer dan eerst de quarantainemarkering in één keer van de hele .app te verwijderen: xattr -cr gramps-connect-desktop.app (uit te voeren in Terminal, in de map waarin u het hebt uitgepakt). Meld het ook — het betekent waarschijnlijk dat het notarisatieticket het downloaden/uitpakken niet zoals verwacht heeft overleefd, of dat de build niet correct is genotariseerd.
• apt/dnf waarschuwt dat het .deb/.rpm niet is ondertekend, of slaat een OpenPGP-controle over — te verwachten. Deze pakketten worden door de eigen CI van deze repository gebouwd, niet gepubliceerd in een ondertekende distributierepository, dus installeren vanuit een lokaal bestand ziet er altijd zo uit; het betekent niet dat er iets mis is.
• dnf: command not found / rpm: command not found — uw distributie is gebaseerd op Debian/Ubuntu (of levert om een andere reden geen rpm mee), dus het .rpm-pakket is de verkeerde download. Neem in plaats daarvan het .deb-bestand en installeer het met sudo apt install ./gramps-connect-desktop_*_amd64.deb (zie de sectie over .deb hierboven).
• Er verschijnt op geen enkel platform een venster of browsertabblad — de app probeert er altijd automatisch een te openen zodra de server draait; als dat op de een of andere manier mislukt, open dan zelf http://127.0.0.1:5050. Als daar ook niets luistert, is er iets gecrasht voordat het zover kwam — bekijk de terminaluitvoer (Windows: start gramps-connect-desktop.exe vanuit een cmd-/PowerShell-venster in plaats van te dubbelklikken, zodat u die kunt zien) op een foutmelding, en overweeg een issue te openen met die uitvoer.
• De app start niet / poort al in gebruik — er kan maar één instantie tegelijk draaien (ze is hardgecodeerd op 127.0.0.1:5050). Sluit elke andere draaiende kopie, of iets anders dat poort 5050 gebruikt, en probeer het opnieuw.
• Er opent een browsertabblad in plaats van een native venster — de app probeert altijd eerst een native venster en valt automatisch terug als dat niet lukt: WebView2 op Windows (standaard aanwezig op Windows 10/11) of WKWebView op macOS (altijd aanwezig) kon niet worden bereikt, of op Linux zijn GTK3 + WebKit2 niet systeembreed geïnstalleerd (installeer python3-gi, gir1.2-gtk-3.0 en gir1.2-webkit2-4.1, of de equivalenten van uw distributie, en start opnieuw om in plaats daarvan een native venster te krijgen). De app werkt hoe dan ook volledig in het browsertabblad — dit beïnvloedt alleen hoe hij wordt gepresenteerd, niet wat hij kan.
• Opnieuw beginnen met een lege stamboom — verwijder de map .gramps-connect-desktop in uw thuismap en start opnieuw.
• Op zoek naar een echte installatie voor meerdere gebruikers in plaats van deze lokale versie voor één gebruiker? Zie Implementeren.

Zie ook de FAQ voor vragen over de veiligheid van uw gegevens en hoe gramps-connect-desktop zich verhoudt tot Gramps Desktop en de serverinstallatie.