From Gramps
Revision as of 21:50, 15 May 2024 by Sam888 (talk | contribs) (minor update to fix installation issue see
Jump to: navigation, search

Research, organize and share your family tree with Gramps.

Gramps Current version: 5.2.3 Released: 2024-04-06

For a list of updates see: What's new?

Before upgrading your distribution

Use your earlier version of Gramps to backup your Family Trees to the hardy and portable XML format.


Linux 220x261.png

For Linux, we recommend installing and upgrading Gramps using the package manager provided by your distribution or by installing a FlatPak available from Flathub.

For advanced users, a source package and Debian package are available:

  • Ubuntu 20.04
  • Ubuntu 22.04

Instructions for how to build from source or install a Debian package are available in the wiki.

Microsoft Windows

Windows 180x160.png

This executable installer supports Microsoft Windows in versions 8, 10, 11 (64-bit Only) and later.

After download: double-click to install Gramps.

Alternatives to the All-In-One installer include the and Chocolatey NuGet Package. Advanced users can install Gramps from source using the MSYS2 build environment.

Older versions available for (Windows 7 64-bit: 5.1.6, Windows 7/8/10 32-bit: 5.1.5, Windows XP/Vista: 3.4.9)

Apple macOS

Macos 200x200.png

Before downloading read the before installation instructions.

After download: Double-click the .dmg file to mount the disk (note: your browser may do this for you automatically). Next, drag the Gramps application to your application folder and double-click to launch it.

Alternatives to the application package include the MacPorts and Homebrew package managers.

BSD platforms

Bsd daemon.png

For BSD, we recommend installing and upgrading Gramps using the package manager provided by your distribution.

Advanced users can build from source using the link in the Linux section.

Further information can be found on the BSD platforms page in the wiki.

Normally, when you try to load your old Family Tree you can allow it to be upgraded if necessary, and it will be opened.

Should this fail for any reason, Create a new Family Tree and Import the backup into this new Family Tree.


Backup to Gramps XML format when updating. Although Gramps reads and writes GEDCOM 5.5.1 format fluently (because it is the de facto format for genealogical data interchange), never depend on such a rudimentary format for archiving your research. GEDCOM cannot store all the intricacies found in Gramps data. Always backup with the more robust Gramps XML format.

Menubar - "Family Trees > Make Backup..."

You will find a Make Backup... option in the Family Trees menu of recent Gramps versions. Alternately, use Export... in the same menu but deselect the privacy and filtering options in the Exporter Assistant to avoid omission of any data.

See: How to make a backup

See also

Installing Gramps for Desktops

Installation instructions specific to the different OSes are on the Linux 32x32.png, Windows 32x32.png,Macos 200x200.png and Bsd daemon.png pages.

GitHub Gramps for Desktops Releases

Wiki pages

Installing Gramps Web for online collaboration

Gramps Web is a frontend for a hosted instance of Gramps