View source for Installing Gramps for Linux computers

{{languages|Installing Gramps for Linux computers}}

{{man warn|Before upgrading your distribution|Use your '''earlier version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees to the hardy and portable [[#1|XML format<sup>1</sup>]].}}

== <span id="Linux distributions"></span>Linux distributions ==
{{man note|These packages are built and supported by the [https://en.wikipedia.org/wiki/Linux_distribution distros (Linux distribution(s))].|If your Linux distribution is not listed you may possibly find it listed on [https://repology.org/metapackage/gramps/versions ''Repology'']<br>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 if you are unable to use either [[#Flathub|Flatpak]] or [[#Snap_from_Canonical_Snapcraft_Store|Snap]].

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

{| {{prettytable}}
!style="width: 85pt;" | Distribution
!GUI Package manager
!Current versions
!Notes
|-
|<span id="debian"></span><!-- Distribution        -->[[File:Debianopenlogo-32.png|link=https://packages.debian.org/search?keywords=gramps]]''' [[Debian]] '''
|<!-- GUI Package manager -->Add/Remove Software
|<!-- Current versions    -->
* Debian 11 ("bullseye"): Gramps 5.1.3  <!--  https://wiki.debian.org/LTS Debian LTS support for Debian 10 "bullseye from August 15th, 2024 to August 31st, 2026   -->
* Debian 11 ("bullseye")([https://packages.debian.org/bullseye-backports/gramps backports]): Gramps 5.1.6
* Debian 12 ("bookworm")([https://packages.debian.org/source/bookworm-backports/gramps backports]): Gramps 5.1.6
* Debian 13 ("trixie")(stable): ([https://packages.debian.org/source/trixie/gramps  Gramps 6.0.1])
* Debian 14 ("[http://packages.debian.org/forky/gramps forky]")(testing): Gramps 6.0.7
* [http://packages.debian.org/sid/gramps sid] (unstable testbed): Gramps 6.0.7
|<!-- Notes               -->[http://packages.debian.org/search?keywords=gramps available versions]
|-
|<span id="ubuntu"></span><!-- Distribution        -->[[File:Ubuntu_32x32.png]] '''[https://ubuntu.com/ Ubuntu]'''
|<!-- GUI Package manager -->Software Centre
|<!-- Current versions    -->
* Jammy (22.04): Gramps: 5.1.5
* Noble (24.04LTS): Gramps: 5.1.6
* Oracular (24.10): Gramps: 5.2.2
* Plucky (25.04): Gramps: 5.2.4
* Questing (25.10):  Gramps: 6.0.1
* Resolute (Development: 26.04):  Gramps: 6.0.6
|<!-- Notes               -->[http://packages.ubuntu.com/search?keywords=gramps&searchon=names available versions]/ (Also see: [https://launchpad.net/~rosco2/+archive/ubuntu/backports Backports])
|-
|<span id="mint"></span><!-- Distribution        -->[[File:Farm-Fresh linux mint.png]]''' [https://www.linuxmint.com/ Linux Mint]'''
|<!-- GUI Package manager -->Software Manager
|<!-- Current versions    -->
* 20.x(Gramps 5.1.2) <!-- EOL April 2025 -->
* 21.x(Gramps 5.1.2) <!-- EOL April 2027 -->
* 22.x(Gramps 5.1.2) <!-- EOL April 2029 -->
|<!-- Notes               -->
* Use the "Software Manager" to install a recent version.
* Manually install the most current version of Gramps using the either of the following suggestions instructions [https://forums.linuxmint.com/viewtopic.php?p=2626875#p2626875 Flatpak newer versions] [https://forums.linuxmint.com/viewtopic.php?t=220159 older versions] from the ''Linux Mint Forums''
* [http://community.linuxmint.com/software/view/gramps Old versions available from Linuxmint]
|-
|<span id="fedora"></span><!-- Distribution        -->[[File:Fedora_32x32.png]] '''[https://getfedora.org/ Fedora]'''
|<!-- GUI Package manager -->Add/Remove Software (Gnome)<br>or<br>Software Management (KDE)
|<!-- Current versions    -->
* <abbr title="Rawhide - Fedora development version">[https://docs.fedoraproject.org/en-US/releases/rawhide/ Rawhide]</abbr> (Gramps 6.0.6)
* Fedora 43 (Gramps 6.0.5)
* Fedora 42 (Gramps 6.0.5)
* Fedora 41 (Gramps 5.2.4-1)
|<!-- Notes               -->[https://packages.fedoraproject.org/pkgs/gramps/gramps/ available versions] (packages.fedoraproject.org)<br />[https://koji.fedoraproject.org/koji/packageinfo?packageID=1969 available versions] (koji Buildsystem)

|-
|<span id="mageia"></span><!-- Distribution        -->'''[https://www.mageia.org/en/ Mageia]'''
|<!-- GUI Package manager -->|[https://wiki.mageia.org/en/Installing_and_removing_software drakrpm (or rpmdrake)]
|<!-- Current versions    -->
* Mageia [https://madb.mageialinux-online.org/show?distribution=cauldron&architecture=x86_64&rpm=gramps&repo=&group=&page= Cauldron]: Gramps 6.0.5
* Mageia 9.0: Gramps 5.1.6
* Mageia 8.0: Gramps 5.1.3
|<!-- Notes               -->[https://madb.mageialinux-online.org/show?distribution=unspecified&architecture=x86_64&graphical=0&rpm=gramps&exact=0 Mageia App Db - gramps]
|-
|<span id="opensuse"></span><!-- Distribution        -->[[File:OpenSUSE-distribution-icon.png|32px]] '''[https://www.opensuse.org/ openSUSE]'''
|<!-- GUI Package manager -->[https://en.opensuse.org/YaST_Software_Management YaST]
|<!-- Current versions    --><!-- https://www.mageia.org/en/support/ -->
* openSUSE Tumbleweed: Gramps 6.0.3
* openSUSE Leap 16.0: Gramps 6.0.3
* openSUSE Leap 15.6: Gramps 6.0.1 <!-- is expected to be maintained until 2025-12-31 https://en.opensuse.org/Lifetime#openSUSE_Leap -->
|<!-- Notes               -->[https://software.opensuse.org/package/gramps available versions]<br>The most recent version can usually be installed from the 'openSUSE BuildService - GNOME:Apps' repository
|-
|<span id="slackware"></span><!-- Distribution        -->[[File:Slackware-distribution-icon.jpg|32px]] '''[http://www.slackware.com/ Slackware]'''
|<!-- GUI Package manager -->
|<!-- Current versions    -->
* 15.0: Gramps 5.2.4 - [https://slackbuilds.org/repository/15.0/misc/gramps/?search=gramps slackbuilds.org]
|<!-- Notes               -->[https://pkgs.org/search/?q=gramps available versions]
|-
|<span id="arch"></span><!-- Distribution        -->[[File:archlinux-icon-crystal-32.svg]] '''[https://www.archlinux.org/ Arch Linux]'''
|<!-- GUI Package manager --> [https://wiki.archlinux.org/index.php/pacman pacman]
|<!-- Current versions    -->
* Gramps 6.0.5
|<!-- Notes               -->[https://archlinux.org/packages/extra/any/gramps/ available versions]
|-
|<span id="gentoo"></span><!-- Distribution        -->[[File:Gentoo-distribution-icon.png|32px]]'''[https://gentoo.org Gentoo&nbsp;Linux]'''
|<!-- GUI Package manager -->
|<!-- Current versions    -->
* Gramps 6.0.4
|<!-- Notes               -->[https://packages.gentoo.org/packages/app-misc/gramps available versions]
|}


{{-}}

== Debian package ==
For [[File:Debianopenlogo-32.png|link=Download#Debian-based]]'''[[Debian|Debian-based linux distributions]]''' (Which includes [[File:Ubuntu_32x32.png|link=Download#Debian-based]]''' Ubuntu ''') <!--[{{github_url}}/releases/v5.1.5 Download the .deb file].-->[{{github_url}}/releases/download/v{{Version Linux Debian}}/gramps_{{Version Linux Debian}}-1_all.ubuntu-24.10.deb 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 ({{man menu|change the filename to match the one you downloaded}}).

 sudo dpkg -i gramps_{{Version Linux Debian}}-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[https://sourceforge.net/p/gramps/mailman/message/35460486/]:

* Find out what version you are running, by using this:

    dpkg-query -s gramps

that queries the package currently installed on your system and gives you info about it.

The line that begin with 'Depends:' contains a list of packages and their version numbers that your current installation depends on
you can compare the required Dependencies with the new version you downloaded with the following command:

    dpkg-deb -I gramps_Version.Number.Of.NewDownload_all.deb

for example, you can get just the two Depends lines to compare using:

    dpkg-query -s gramps | grep Depends:
    dpkg-deb -I gramps_5.Version-Number_all.deb | grep Depends:

* 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.'''

== Flathub ==
Gramps {{Version Linux Flatpak}} is available as a Flatpak at [https://flathub.org/apps/search?q=gramps Flathub]. Flatpaks allow installing sandboxed versions of applications, which will work on any linux distribution.
=== Flatpak ===
'''Things to consider regarding the flatpak:'''

1. All flatpaks from Flathub are compiled at Github with their dependencies. If someone wants a dependency for an Addon not supported by the flatpak, then a repository or source install might be a better option. There is a list of dependencies included in the Gramps flatpak at  https://github.com/gramps-project/flatpak . If you would like another dependency to be considered for addition to the flatpak, please submit an issue at https://github.com/gramps-project/flatpak/issues

2. Directory access to the Gramps flatpak at Flathub is limited by default to the user's home directory. However, another app named Flatseal can change the sandbox permissions. https://flathub.org/en/apps/com.github.tchx84.Flatseal

3. If you use Fedora, Fedora maintains its own Gramps flatpak in addition to the Gramps flatpak available at Flathub. The Fedora flatpak has a different list of dependencies. Here is the link to Fedora's Gramps flatpak https://koji.fedoraproject.org/koji/packageinfo?packageID=39415

4. '''Support for BSDDB3 got dropped in the Gramps 5.2 flatpak at Flathub.''' If you need to access a BSDDB3 database to convert it to Sqlite, there are a few options. The Fedora flatpak might include BSDDB3, and the archived 5.1.6 Gramps flatpak at the gramps-project github https://github.com/gramps-project/flatpak/releases/tag/v5.1.6-1 includes BSDDB3. However, the archived flatpak at the gramps-project link will eventually stop working because Flathub removes obsolete runtimes after a certain length of time. If neither flatpak option works, then a manual intall of BSDDB3 with a repository or source install of Gramps will be required.

'''Recommended steps to install the Gramps flatpak:'''

1. There are instructions for setting up and enabling Flathub for various distributions at https://flathub.org/setup

2. Use the blue install button at https://flathub.org/apps/details/org.gramps_project.Gramps if you set your software manager up to work with Flathub, or use the command below in a terminal:

 flatpak install org.gramps_project.Gramps

== Snap from Canonical Snapcraft Store ==
The Gramps snap is a Linux app packages for desktop, cloud and IoT that can be installed from the Canonical Snap Store, the app store for Linux.

To install run:

<code>sudo snap install gramps</code>

It has been bundled with the same packages as our Flatpak:

*    ICU
*    PIL
*    osm-gps-map
*    GExiv2
*    geocodelib
*    goocanvas
*    graphviz
*    ghostscript
*    networkx

These should allow some popular addons to work.

Dictionaries are not currently included. This would be possible, but the package size would obviously increase.

Let us know what you think. Comments from people who already use snaps would be especially welcome.


See also:
* [https://snapcraft.io/gramps snapcraft.io/gramps]
* [https://gramps.discourse.group/t/gramps-is-now-available-as-a-snap/7380 Gramps is now available as a Snap]
** [https://gramps.discourse.group/t/after-snap-install-help-request-on-facebook-group/7387 Snap Feedback]

== Build from source ==
For other distributions, [[File:Download_link.png|150px|link={{github_url}}/releases/v{{version}}]] the source and follow the instructions for [[Linux:Build from source]]

== Linux Live CD ==

{{man warn|Outdated version warning|Note this '''Linux live CD Demonstration''' includes Gramps {{Version Linux Live CD}} (an older version released 2010-11-17) and it is not recommended for general use}} 

[[File:Download_link.png|150px|left|link=https://sourceforge.net/projects/gramps/files/gramps-cdrom/lgenealogy-6.1-desktop-i386.iso/download]]
'''Linux live CD Demonstration''' includes Gramps {{Version Linux Live CD}} 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, [https://rufus.ie/en/ Rufus]..). [[Linux_Genealogy_CD#Download_the_CD|Download the CD]] (727 MB). The [[Linux Genealogy CD|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 [http://www.ubuntulinux.org/ Ubuntu] and Gramps from the CD anytime you like.
{{-}}

== Online Demonstration ==
{{man warn|Buyer Beware|The following is a limited trial of a commercial cloud VM service (rollApp) that operates by subscription. The listing here is '''''not''''' an endorsement by the Gramps-project.<br /><br />Beware of giving third parties access to your genealogical data.}}

You can also try an online demonstration of version 5.2.3 of Gramps on rollApp (''"Cloud platform for native applications"'') categorized under '''[https://www.rollapp.com/apps/utilities Utilities]''' - ''[https://www.rollapp.com/apps/diagrams #diagrams]'': 

* https://www.rollapp.com/app/gramps

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

{{-}}

== Notes ==
<span id="1">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.</span> 

[[File:Menubar-FamilyTrees-overview-FamilyTree-Loaded-example-60.png|thumb|right|450px|Menubar - {{man menu|"Family Trees > Make Backup..."}}]]

You will find a [[Gramps_{{man version}}_Wiki_Manual_-_Manage_Family_Trees#Backing_up_a_Family_Tree|{{Man menu|Make Backup...}}]] option in the {{Man menu|Family Trees}} menu of recent Gramps versions. Alternately, use [[Gramps_{{man version}}_Wiki_Manual_-_Manage_Family_Trees#Exporting_data|{{Man menu|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 [[File:linux_32x32.png|link=Installing_Gramps_for_Linux_computers#Linux_distributions]], [[File:windows_32x32.png|link=Installing_Gramps_for_Windows_computers]],[[File:macos_200x200.png|32px|link=Installing_Gramps_for_macOS_computers]] and [[File:Bsd daemon.png|32px|link=BSD_platforms]] pages.

===GitHub Gramps for Desktops Releases===<!--github_url template = https://github.com/gramps-project/gramps -->
:* [{{github_url}}/releases/v{{version}} {{version}} version]
:* [{{github_url}}/releases/ Archive of Gramps releases] 
Wiki pages
* [[Previous releases of Gramps]]
* [[:Category:Versions|Versions on various platforms]] 

===Installing Gramps Web for online collaboration===
[https://gramps-project.org/blog/web/ Gramps Web] is a frontend for a hosted instance of Gramps.
* [https://www.grampsweb.org/Deployment/ Docker] 
* [https://www.grampsweb.org/LetsEncrypt/ Let's Encrypt und Docker Compose]

[[Category:Documentation]]