genealogy

Gramps Genealogy Software: Setup And Guide

Tracing your ancestors doesn't require an expensive subscription to a commercial genealogy platform. If you want full control over your research data without vendor lock in or recurring fees, open sou

Gramps Genealogy Software: Setup And Guide
In this story

Tracing your ancestors doesn't require an expensive subscription to a commercial genealogy platform. If you want full control over your research data without vendor lock-in or recurring fees, open-source software offers a powerful alternative. Gramps stands out as one of the most flexible options for serious family historians.

Whether you're migrating from a proprietary platform or starting your first family tree from scratch, setting up open-source genealogy software can feel overwhelming. This guide covers how to install Gramps, structure your research, manage sources correctly, and avoid common data management pitfalls.

What is Gramps Genealogy Software?

Gramps (Genealogical Research and Analysis Management Programming System) is a free, open-source genealogy program available for Linux, macOS, and Windows. Developed by a global community of contributors, it stores your family history in a local database rather than a locked cloud silo.

Unlike web-based trees that charge monthly fees and restrict data export, Gramps lets you own your files entirely. It handles complex family structures, same-sex marriages, multiple partnerships, and non-traditional lineages with ease. You can organize individuals, families, events, places, sources, citations, and media objects into a fully relational database.

Installing and Setting Up Your First Family Tree

Getting started takes just a few minutes, but organizing your database structure early prevents messy data cleanup later.

  1. Download the installer for your operating system from the official Gramps website.
  2. Run the installer and complete the setup wizard. On macOS and Windows, make sure you have the required runtime dependencies installed if prompted.
  3. Open Gramps and create a new Family Tree. Give it a distinct name, such as your family surname or project focus.
  4. Go to Edit > Preferences to configure your default researcher name, preferred date formats, and geographic coordinate displays. Setting these early ensures consistent data entry.

Entering Data: People, Events, and Relationships

Gramps revolves around a primary object model built on people and events. Understanding how these connect is vital for accurate research.

Adding Individuals and Facts

When you add a person, you input basic details like given names, surnames, gender, and nicknames. However, Gramps separates names from events. A person's birth isn't just a text field on their profile; it's an independent event object that includes a date, a place, and supporting citations.

Link attributes carefully. Instead of typing "born in 1885" into a notes field, create a Birth event, assign the date, link a place record, and attach your census or birth certificate source directly to that event.

Structuring Families

Families in Gramps represent relationships between parents and children. You can define relationship types—such as married, civil union, unmarried, or unknown—along with marriage and divorce events. If an individual has multiple spouses or children from different relationships, Gramps links them cleanly without breaking the tree hierarchy.

Managing Places and Sources Like a Pro

The biggest mistake beginners make is treating sources and places as casual text notes. Gramps provides dedicated views for both to keep your research verifiable.

The Place Hierarchy

Gramps uses a hierarchical place structure. Instead of typing "Chicago, Cook, Illinois, United States" into every individual record, you build a place tree.

  • Define the country: United States
  • Define the state: Illinois
  • Define the county: Cook
  • Define the city: Chicago

When you attach Chicago to an event, Gramps associates it with its parent jurisdictions automatically. This makes geographic filtering and mapping tools infinitely more powerful later.

Sources and Citations

Good genealogy requires proof. Gramps separates Sources (the repository, book, or microfilm collection) from Citations (the specific page, entry, or line item).

  • Create a Source record for the 1900 United States Federal Census.
  • Create a Citation under that source for Sheet 4A, household 42, line 12, and paste the image or transcript in the citation notes.
  • Link that citation to the specific birth, residence, or immigration events it proves.

Importing and Exporting Data (GEDCOM and Beyond)

Moving data between platforms is simple, provided you format your files correctly. Gramps uses its own XML format (.gramps) as its native backup, which preserves every scrap of metadata, media link, and custom note.

To import an existing tree from Ancestry, FamilySearch, or MyHeritage, export your data as a GEDCOM (.ged) file. In Gramps, select Family Trees > Import and choose your GEDCOM file.

Watch out for common import errors:

  • Media path breaks: GEDCOM files only store file paths, not the actual images. You'll need to relocate or re-link multimedia folders after importing.
  • Custom tags: Proprietary software often creates custom tags that GEDCOM drops or corrupts. Review your imported notes and attributes for misplaced text.

To share your tree with relatives who don't use the software, use the Reports or Tools menu to generate interactive HTML web pages, PDF books, or pedigree charts.

Frequently Asked Questions

Is Gramps really free?

Yes. Gramps is open-source software licensed under the GPL. There are no paywalls, premium tiers, or hidden subscription fees.

Where is my data stored?

Your data lives entirely on your local hard drive in a Berkeley DB or SQLite database structure. Nothing is uploaded to a third-party server unless you choose to export and share it yourself.

Can I sync Gramps across multiple computers?

Gramps doesn't feature built-in automatic cloud syncing like commercial apps. However, you can sync your data folder using cloud storage providers like Nextcloud, Dropbox, or a local network drive, provided you close the application on one device before opening it on another to avoid database locks.

How do I add old photographs and documents?

Go to the Media view, click the plus icon, and select your image files. Once added to the media manager, you can drag and drop them onto specific people, events, or source citations to build a rich visual archive.

IC

Written by

Isabella Carter

As a veteran correspondent, Isabella Carter has reported from across the globe, bringing firsthand perspectives to international stories and local issues.

More from genealogy