From Gramps
Revision as of 15:56, 7 January 2023 by Bamaustin (talk | contribs) (Linux and BSD distributions: clarify "Rawhide" as the development version of Fedora linux distro)
Jump to: navigation, search

Research, organize and share your family tree with Gramps.

Gramps is a free software project and community. We strive to produce a genealogy program that is both intuitive for hobbyists and feature-complete for professional genealogists. It is a community project, created, developed and governed by genealogists.

Gramps Current version: 5.2.2 Released: 2022-02-05

Different data format to the GRAMPS 3.4 series. Full Python 3 support only as Python 2 support dropped. Uses GTK+ 3 GUI. Default database is now SQLite. Lot of updates see: What's new?
Linux 220x261.png Windows 180x160.png Macos 200x200.png Bsd daemon.png


Linux 220x261.png

Before upgrading your distribution: Use your earlier version of Gramps to backup your Family Trees to the hardy and portable XML format1.

via Distributions      via Flathub      Latest version (5.2.2) (advanced users only)

MS Windows

Windows 180x160.png

Before downloading the All-In-One software installer bundle for Windows: Use your earlier version of Gramps to backup your Family Trees to the hardy and portable XML format1.

This installer supports Microsoft Windows in all versions Vista/7 and later. The 64-bit versions of Windows allow more efficient access to more resources.

(Please note: Gramps prefers the Python-3.5 and Gtk-3.18 libraries and newer. Those libraries have dropped support for Windows XP. But Gramps can still be run on Windows XP with earlier library versions, i.e., Python3.4.4 and Gtk-3.16)

After download: double-click to install Gramps.
By default: new releases will be added in a new directory and earlier installations of Gramps will not be overwritten; the language will be a mix of British and US English.


During installation, one shortcut is placed on the desktop and two shortcuts are added the Start menu.
Please only use the 'console' secondary shortcut when performing diagnostics requested by a developer.
1) GrampsAIOXX 5.2.2 ← for normal use of Gramps
GrampsAIOXX 5.2.2-console

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 back-up into this new Tree.

Use the Windows AIO (All-In-One) version, please use the download links above. For more information about individual versions, console and debug modes, release notes, etc., look at this page (English only). Or, you might want to look at the description of what is meant by an All In One Bundle.

Alternative independent installation


If needed, there are alternatives to the All-In-One installer.

When launching the PortableApps fork of Gramps, this splash screen appears.

A PortableApps version will run from an external device without the requirement of installing on the OS drive. PortableApps installations are not for touchscreen-based mobile devices. They just allow the application to run from external storage, USB thumbdrives.

You can download the 5.2.1 Gramps Portable version from:

Note that also has a Legacy 3.4.9 version of Gramps available -- although it is not recommended for general use; just for recovering older format databases.

Portable Gramps from includes all dependencies required for Windows. Note:You can install it on C: then to run Gramps type C:\PortableApps\GrampsPortable\GrampsPortable.exe (Or the path you installed it to) or make a shortcut to that file on your desktop or start-menu. Please report packaging issues here

Chocolatey NuGet Package

You may also install using the alternative independent Gramps Chocolatey NuGet Package

Chocolatey NuGet is a Machine Package Manager, somewhat like apt-get, but built with Windows in mind.

Gramps for Windows with MSYS2

How to use MSYS2 to run latest Gramps development version from source in 64bit Windows.

Missing other languages

Microsoft Window Gramps AIO Installer Choose Components-Selection window.

The default Gramps AIO installer will embed the US dialect of English for the interface with the British spellcheck dictionary.

If you prefer a different language (or spell with the US or Australian dialects of English), please ensure that you pay special attention to the Choose Components phase of the installation.

To install a language other than English, select from both the Translations and Dictionaries during the Choose Components phase of the installation.

Even your primary language is installed by default, you might anticipate the need to spellcheck Notes in other than the British dialect of English. Be certain to select the appropriate languages from Dictionaries. Gramps will not access your Operating System's native dictionary.

There is no simple facility for adding interface or dictionary languages after installation.


Macos 200x200.png

Before downloading the ready-to-run stand-alone bundle: Use your earlier version of Gramps to backup your Family Trees to the hardy and portable XML format1. Read the before installation instructions.

Tested for compatibility with Apple macOS/Mac OS X versions 10.13 (High Sierra) through 13 (Ventura). Help determining your Operating System version can be found in the HT201260 Apple Support article.

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. (For Apple Mac OS X, alternatively, you can click and hold on the disk icon at the top of the window of the mounted disk, and then option-drag to the Applications folder. This will create a new folder containing all the files, including the README and NEWS.)

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 back-up into this new Tree.

Alternative independent installation


Alternatively, Gramps can also be built and installed on macOS using MacPorts.


MacPorts is a package manager for Apple Mac.

Why use the version from MacPorts? Certain plugins or add-ons require additional supporting software in order to operate. With MacPorts, you can install such software easily (most of the time; there could be exceptions). With the official .dmg installer, installing such additional software is more difficult or impossible.

The Prequisites Checker can identify if any add-ons have been installed that require such additional software.


The macOS application bundle can also be installed via the Homebrew package manager as a cask. Note that this is *not* a Homebrew build, it is a repackaging of the same provided in the above dmg. It does not depend on or use any of the Homebrew-built libraries.

Homebrew is an open-source package manager for macOS (and Linux).


Adding additional Spell Checking languages on macOS


Gramps uses a different spell checker than the one provided by Mac OS X, with different spelling dictionary requirements. We can't easily provide dictionaries for all of the supported languages in the bundle, but they're easily downloaded from's website. Download the language you want and save it, then navigate to the download in Finder. Most browsers have a downloads window that offers "Show in Finder" in its context menu. Change the file extension from oxt to zip, then from the context menu select Open with... Archive Utility to decompress it. In the decompressed folder or perhaps in a subfolder you'll find the dictionary files in pairs, foo.aff and foo.dic. Some languages have more than one pair with a README file to explain why. Select a pair and copy it to /Library/Dictionaries (you'll have to authenticate with an administrator id and password), and if 'foo' isn't already a language or locale code, make it one. For example, the French package includes several pairs with names like fr-moderne.aff and fr-moderne.dic. The spell checker doesn't recognize those names, so when you copy them to /Library/Dictionaries you must rename them to fr.aff and fr.dic or fr_FR.aff and fr_FR.dic. You can have more than one dictionary pair installed if you use several languages, but one must match the language you use for Gramps or spell checking won't be enabled at all.

Linux and BSD distributions

These packages are built and supported by the distros.

If your distribution is not listed you may possibly find it listed on Repology
Please report any problems with them to the package maintainer.

Most Linux distributions come bundled with a version of Gramps, though it's not always the most recent version and it may not have been installed by default. Still it is recommended to use the Gramps version that comes with your distribution.

Below are ways to install Gramps on some of the more popular distributions:

Distribution GUI Package manager Current versions Notes
Debianopenlogo-32.png Debian Add/Remove Software
  • Debian 10 ("buster") (old stable): Gramps 5.0.1
  • Debian 10 ("buster")(backports) (stable): Gramps 5.1.2
  • Debian 11 ("bullseye")(stable): Gramps 5.1.3
  • Debian 11 ("bullseye")(backports): Gramps 5.1.5
  • bookworm (testing): Gramps 5.1.5
  • sid (unstable): Gramps 5.1.5
available versions
Ubuntu 32x32.png Ubuntu Software Centre
  • Bionic Beaver (18.04 LTS): Gramps: 5.1.2
  • Focal (20.04 LTS): Gramps: 5.1.3
  • Hirsute (21.04): Gramps: 5.1.3
  • Impish (21.10): Gramps: 5.1.4
  • Jammy (Development: 22.04): Gramps: 5.1.5
available versions/ (Also see: Backports)
Farm-Fresh linux mint.png Linux Mint Software Manager
  • 19.x(Gramps 4.2.8)
  • 20.x(Gramps 5.1.2)
Fedora 32x32.png Fedora Add/Remove Software (Gnome)
Software Management (KDE)
  • Rawhide (Gramps 5.1.5)
  • Fedora 34 (Gramps 5.1.5)
  • Fedora 35 (Gramps 5.1.5)
  • Fedora 36 (Gramps 5.1.5)
  • Fedora 37 (Gramps 5.1.5)
available versions
Mageia drakrpm (or rpmdrake)
  • Mageia Caulron: Gramps 5.1.5
  • Mageia 8.0: Gramps 5.1.3
Mageia App Db - gramps
OpenSUSE-distribution-icon.png openSUSE YaST
  • openSUSE Tumbleweed: Gramps 5.1.5
  • openSUSE Leap 15.3: Gramps 4.2.8
available versions
The most recent version can usually be installed from the 'openSUSE BuildService - GNOME:Apps' repository
Slackware-distribution-icon.jpg Slackware available versions
Archlinux-icon-crystal-32.svg Arch Linux pacman
  • Gramps 5.1.5
available versions
Gentoo-distribution-icon.pngGentoo Linux
  • Gramps 5.1.4
  • Gramps 5.1.5 (testing)
available versions
  • OpenBSD: Gramps 5.1.5
available versions

Linux: Install latest version

If your distribution doesn't ship with Gramps or you wish to install a different version than it ships with, you could try to install the latest version of Gramps manually.

Warning before attempting to install the latest Gramps version, use your existing installation to make a Gramps XML backup

Software updates should only be attempted by experienced users, and after having backed up your data... specifically, your Family Trees.

The version of Gramps that has been included in your distribution will have been tested to work with the components in that distribution. When trying to install a different version of Gramps, there is a possibility that the components needed for the new version of Gramps will not be available for your distribution Or, that the components are available but don't work properly. Such problems might not discovered until after you have already done some work with the new version of Gramps.

If you already have Gramps installed, and you are only making a 'point' upgrade (i.e., from Gramps x.y.z to x.y.z+1, e.g., from 5.1.3 to 5.1.5), then it is probable that Gramps will continue to work. However, if the change is much greater, especially if it is a major version change (e.g., from 4.y.z to 5.y.z), then the chance that of incompatibilities is much greater.


For Debianopenlogo-32.pngDebian-based linux distributions (Which includes Ubuntu 32x32.png Ubuntu ) Download the .deb file. Double-click on the downloaded .deb file or (for some distributions, e.g. Mint Debian) run the following command from the directory where the file was saved (change the filename to match the one you downloaded).

sudo dpkg -i gramps_5.2.2-1_all.deb

If you have an error about having unmet dependencies run:

sudo apt-get -f install

to install the dependencies.

If you see an error about an incomplete GTK installation and missing language translations when starting Gramps, run

sudo apt install language-pack-gnome-en

to install the proper language pack. You may need to replace 'en' with your own language code, like 'nl' for Dutch.

Useful command lines

Before upgrading you can[1]:

  • Find out what version you are running, by using this:
   dpkg-query -s gramps

that queries the package and gives you info about it.

  • If you are committed to an upgrade then make sure you have backed up you Family Trees to Gramps XML then run :
   sudo dpkg -r gramps

this will remove the current gramps package (assuming its a python3 version older versions could be python-gramps )

  • To stop Ubuntu updating gramps (to possibly an older version from Ubuntu!) you may need to run:
   sudo apt-mark hold gramps

Upgrade is then complete.


Gramps 5.2.1-0 is available as a Flatpak at Flathub.

Please use your existing installation to backup your database before proceeding.

Also, it is a good idea to convert your database to SQLite even though there is currently BSDDB3 support in the 5.2.1-0 Flatpak.

First set up Flatpak and the Flathub repository on your system, there are instructions for various distributions at

Second, you can use the blue install button at if you set your software manager up to work with Flathub, or use the command below in a terminal for a system wide installation if you have sudo privileges:

flatpak install flathub org.gramps_project.Gramps

For other distributions

For other distributions, Download link.png the source and follow the instructions for Linux:Build from source


Bsd daemon.png

Before upgrading your distribution: Use your old version of Gramps to backup your Family Trees [1].

via Distributions      Latest version (advanced users only)

See also:

Linux Live CD

Note this Linux live CD Demonstration includes Gramps 3.2.5 an old version released 2010-11-17 and it is not recommended for general use

Download link.png

Linux live CD Demonstration includes Gramps 3.2.5 pre-installed to trial, without touching anything on the hard drive. To start this boot the Computer with this Live Linux Desktop on a CD in the CD/DVD-ROM Drive. (Requires that you write this image to a CD-ROM using CD-Burner software eg:Nero, Imgburn, Rufus..). Download the CD (727 MB). The Linux Genealogy CD is based on Ubuntu 10.10 (Maverick Meerkat). If you are interested in Gramps, but are afraid to actually install it or unable to install it (not your PC, windows, no internet at home, work laptop, ...), then try out our Linux Genealogy CD. It runs without installing on the hard disk and contains a collection of open source, free, genealogy programs. You can then install latest Ubuntu and Gramps from the CD anytime you like.

Online Demonstration

Buyer Beware

This is a limited trial of a commercial cloud VM service that operates by subscription. This is not an endorsement by the Gramps-project.

Beware of giving third parties access to your genealogical data.

You can also try an online demonstration of version 5.1.4 of Gramps on rollApp ("Cloud platform for native applications") categorized under Utilities - #diagrams:

Select Launch Online then Test Drive(Opening/saving files will not be available)


[1] Backup to Gramps XML. You will find backup in the Family Tree menu of recent Gramps versions, otherwise use export in the same menu but uncheck privacy options in the Exporter Assistant in order to export all data. See : How to make a backup

See also