__NOTOC__{{languages|Download}}== Linux ==[[File:Gramp-Small-background-wiki-2020.jpg|120px|left]]'''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.{{-}}{{man note|{{Man menu|Gramps '''Current version: '''{{version}}''' Released: '''{{version-released}}'''}}|For a list of updates see: ''[[Image:Linux_220x261Gramps 6.png|128px0 Wiki Manual - What's new?|leftWhat's new?]]}}
{{man warn|Before upgrading your distribution: |Use your '''old earlier version of Gramps''' to [[How_to_make_a_backup#GRAMPS_version_3Gramps_version_3.3_and_later|backup]] your Family Trees to the [[#1|[1]hardy and portable XML format]].}}
<hr />
<span id="linux" style="font-size:120%">Linux</span>
[[File:Linux_220x261.png|128px|left|link=Installing_Gramps_for_Linux_computers]]
<big>
<u>For Linux, we recommend installing and upgrading Gramps using either [https://wikipedia.org/wiki/Flatpak FlatPak] or [Download#Linux distributions|via Distributionshttps://en.wikipedia.org/wiki/Snap_(software) Snap]:* A Flatpak is available from [https://flathub.org/apps/org.gramps_project.Gramps Flathub]<. ([https://gramps.discourse.group/t/need-help-upgrading-to-6-0-5-flatpak-on-ubuntu-24-04/8765/u> 4 Flatpak doesn’t include the BSDDB database backend.])<u>* A Snap is available from the [[Download#Linuxhttps:_Install_latest_version|Latest version ({{version}}) (advanced users only)//snapcraft.io/gramps Snap Store]]</u>.</big>{{-}}
== MS Windows ==Gramps may also be available in the '''[https://wikipedia.org/wiki/List_of_software_package_management_systems package manager]''' provided by your [[Installing_Gramps_for_Linux_computers#Linux_distributions|distribution]]. However, this is likely to be out-of-date in some popular distributions.
For advanced users, a source package is available:* <u>[[Image:windows_180x160{{github_url}}/archive/refs/tags/v{{version}}/v{{version}}.tar.png|128px|left]gz Source Package {{version}}]</u>
Before download: Use your '''old version of Gramps''' Instructions for how to [[How_to_make_a_backup#GRAMPS_version_3.3_and_laterLinux:Build from source|backup]] your Family Trees [[#1|[1]build from source]]are available in our wiki.
{{-}}<hr /><bigspan id="windows" style="font-size:120%">Microsoft Windows<u/span>[[httpFile://sourceforgewindows_180x160.net/projects/gramps/files/Stable/{{version_windows_AIO32}}/{{filename_windows_AIO32}}.exe png|128px|left|link=Installing Gramps for Windows computers]]This executable installer supports Microsoft Windows Installer in versions 8, 10, 11 (3264-bitOnly) {{version_windows_AIO32}}]and later.</ubig> * <u>[http:{{github_url}}/releases/sourceforge.net/projects/gramps/files/Stabledownload/v{{version_windows_AIO64}}/{{filename_windows_AIO64}}.exe Windows Installer (64-bit) {{version_windows_AIO64}}]</u></big>After download: '''double-click to install Gramps'''.
After download: doubleAlternatives to the All-click to In-One installer include the [[Installing_Gramps_for_Windows_computers#PortableApps.com|PortableApps.com]] and [[Installing_Gramps_for_Windows_computers#Chocolatey_NuGet_Package|Chocolatey NuGet Package]]. Advanced users can install Grampsfrom source using the [[Gramps_for_Windows_with_MSYS2|MSYS2]] build environment.
Normally, when you try to load your old Family Tree you can allow it to be upgraded if necessary, and it will be openedFinal Gramps versions for legacy Windows systems (PortableApps format): Windows 7 64-bit: [https://portableapps.com/downloading/?a=GrampsPortableLegacyWin7&s=s&p=&d=pa&n=Gramps%20Portable&f=GrampsPortableLegacyWin7_5.1.6_Rev_2.paf.exe 5.1. However if this fails for any reason6], Windows 7/8/10 '''Create32-bit''' : [https://portableapps.com/downloading/?a=GrampsPortableLegacyx86&s=s&p=&d=pa&n=Gramps%20Portable&f=GrampsPortableLegacyx86_5.1.5.paf.exe 5.1.5], Windows XP/Vista: [https://portableapps.com/downloading/?a new Family Tree and '''Import''' =GrampsPortableLegacy3&s=s&p=&d=sfpa&n=Gramps%20Portable&f=GrampsPortableLegacy3_3.4.9.paf.exe 3.4.9]{{-}}<!-- * <u>[{{github_url}}/releases/download/v{{version_windows_AIO32}}/{{filename_windows_AIO32}}.exe Windows Installer (32-bit) {{version_windows_AIO32}}]</u></big> --><hr /><span id="macos" style="font-size:120%">Apple macOS</span>[[File:macos_200x200.png|128px|left|link=Installing Gramps for macOS computers]]Before downloading read the back[[Mac_OS_X:Application_package#Before_installation|before installation]] instructions.<big>* <u>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_intel}}.dmg Intel {{version_Mac}}]</u>* <u>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_arm}}.dmg Apple Silicon {{version_Mac}}]</u></big>After download: Double-up into click the .dmg file to mount the disk (note: your browser may do this new Treefor you automatically). Next, drag the Gramps application to your application folder and double-click to launch it.
Alternative independent MS Windows version Alternatives to the [[Mac_OS_X:Application_package|application package]] include the [[Installing_Gramps_for_macOS_computers#3MacPorts|MacPorts]] and [3][Installing_Gramps_for_macOS_computers#Homebrew|Homebrew]]package managers.
== Mac OS X == [[Image:macos_200x200.png{{man warn|128px|left]] Before download: Use your '''old version of The Gramps app on Apple’s App Store is in no way affiliated with the Gramps''' to [[How_to_make_a_backup#GRAMPS_version_3project.3_and_later|backup]] your Family Trees [[#1|[1]]]. Read the [[Mac OS XSee:Application package|before installation]] instructions. Mac OS X 10.5, 10.6 and 10.7 <big><ubr>* 2025 Forum discussion [httphttps://sourceforgegramps.discourse.netgroup/projectst/ios-app-named-gramps/files6756/Stable/{{version_Mac4 iOS app named “Gramps”]}}/{{filename_mac_intel-}}.dmg Intel {{version_Mac}}]</u><hr /big> Mac OS X 10.5 <bigspan id="bsd" style="font-size:120%">BSD platforms<u/span>[http[File://sourceforgeBsd daemon.net/projects/gramps/files/Stable/{{version_Mac}}/{{filename_mac_ppc}}.dmg Power PC {{version_Mac}}png|128px|left|link=BSD platforms]]</u></big>
After download: Double-click For BSD, we recommend installing and upgrading Gramps using the .dmg file to mount the disk (note'''[https: your browser may do this for you automatically)//wikipedia. Next drag the Gramps application to org/wiki/List_of_software_package_management_systems package manager]''' provided by your application folder and double-click to launch it [[BSD platforms#2BSD_distributions|[2]distribution]].
Normally, when you try to load your old Family Tree you Advanced users can allow it to be upgraded if necessary, and it will be opened. However if this fails for any reason, '''Create''' a new Family Tree and '''Import''' [[Linux:Build from source|build from source]] using the back-up into this new Treelink in the Linux section.
Further information can be found on the [[BSD platforms]] page in the wiki.
{{-}}
<hr />
== BSD == Before upgrading your distribution: Use {{man tip|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, '''old version of GrampsCreate''' to a new Family Tree and [[How_to_make_a_backup#GRAMPS_version_3.3_and_laterHow_to_restore_a_backup|'''Import''' the backup]] your into this new Family Trees [[#1|[1]]]Tree. <big><u>[[Download#Linux and BSD distributions|via Distributions]]</u> <u>[[Download#Linux:_Install_latest_version|Latest version (advanced users only)]]</u></big>}}
{{-}}
== Live CD == [[Image:Download_link.png|150px|left|link=http://sourceforge.net/projects/gramps/files/OldFiles/3.2.5/lgenealogy-6.1-desktop-i386.iso]]'''Linux live CD Demonstration''' [[Linux_Genealogy_CD#Obtaining_the_CD|Obtaining the CD]] (727 MB) [[Linux Genealogy CD|Linux Genealogy CD based on Ubuntu 10.10 (Maverick Meerkat)]]. Allows you to trial a pre-installed Gramps {{Version Linux Live CD}}, 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..). 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 [http://www.ubuntulinux.org/ Ubuntu 10.10] and Gramps from the CD anytime you like. [[Image:Download_link.png|150px|left|link=http://cdimage.ubuntu.com/edubuntu/releases/13.04/release/]]''Edubuntu 13.04'' includes Gramps 3.4.0 == <span id="Linux distributions"></span>Linux and BSD distributions == 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: {| border="1" cellspacing="0"|Distribution|GUI pkg manager|Current versions|Notes|-|'''Linux Mint'''|Software Manager|Nadia: Gramps 3.4.0-1<br>Lisa: Gramps 3.3.1-1<br>Isadora: Gramps 3.2.0-1 ||-|''' Mageia '''||||-|[[Image:Ubuntu_32x32.png]]''' Ubuntu '''| Software Centre|Quantal: Gramps 3.4.0-1|[http://packages.ubuntu.com/quantal/gramps available versions]|-|[[Image:Fedora_32x32.png]]''' Fedora ''' |Add/Remove Software (Gnome) or <br>Software Management (KDE)|Fedora Rawhide: Gramps 3.4.3<br>Fedora 18: Gramps 3.4.2.||-|[[Image:Debianopenlogo-32.png]]''' Debian '''|Add/Remove Software|squeeze (old stable): Gramps 3.2.3<br>wheezy (stable): Gramps 3.4.0<br>jessie (testing): Gramps 3.4.0<br>[http://packages.debian.org/sid/gramps sid (unstable)]: Gramps 3.4.0|[http://packages.debian.org/search?keywords=gramps available versions]|-|[[Image:Mandriva_32x32.png]]''' Mandriva '''|Software Management in the <br>Mandriva Linux Control Center||Mandriva 2010.1: Gramps 3.3.1<br>Mandriva 2011: Gramps 3.2.6<br>See also [http://wiki.mandriva.com/en/Docs/Basic_tasks/Installing_and_removing_software#Advanced_use:_Backports_and_candidate_updates backports] and contrib repository|-|[[Image:Redhat_32x32.png]]''' Redhat '''||||-|''' openSUSE ''' |YaST ??|openSUSE 12.3: Gramps 3.4.2|[http://software.opensuse.org/package/gramps available versions]|-|'''Slackware'''||Slackware 14.0: Gramps 3.4.2|[http://pkgs.org/search/?keyword=gramps available versions]|-|'''NetBSD'''||NetBSD: Gramps 3.4.3|[http://pkgsrc.se/databases/gramps3 available versions]|-|'''FreeBSD'''||FreeBSD: Gramps 3.3.0|[http://portsmon.freebsd.org/portoverview.py?category=science&portname=gramps available versions]|-|'''PC-BSD'''||PC-BSD: Gramps 3.3.0||}
{{-}}
== 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>
== Linux[[File: 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 manuallyMenubar-FamilyTrees-overview-FamilyTree-Loaded-example-60. Instructions are given below for a number of distributionspng|thumb|right|450px|Menubar - {{man menu|"Family Trees > Make Backup..."}}]]
You will find a [[Gramps_{{man warnversion}}_Wiki_Manual_-_Manage_Family_Trees#Backing_up_a_Family_Tree|1=Warning{{Man menu|2=This should only be attempted by experienced usersMake 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 after you have backed up your Family Treefiltering options in the Exporter Assistant to avoid omission of any data.
The version of Gramps that has been included in your distribution will have been tested See: [[How to work with the components in that distribution. If you try to install a different version of Gramps there is a possibility that the components needed for the new version of Gramps are not available for your distribution, or they are available, but don't work properly. You might not discover that there is make a problem till you have already done some work with the new version of Gramps.backup]]
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 3.4.3 to 3.4.4), then it is likely but not certain that Gramps will continue to work. However, if the change is much greater, especially if it is a major version change (e.g. from 2.y.z to 3.y.z), then the danger that it does not work properly is much greater.}}== See also ==* Installer [[Team#Package_Maintainers|package maintainers]]
===Installing Gramps for Desktops===Installation instructions specific to the different OSes are on the [[ImageFile:Debianopenlogo-32linux_32x32.png|link=Installing_Gramps_for_Linux_computers#Linux_distributions]]'''Debian''' and , [[ImageFile:Ubuntu_32x32windows_32x32.png|link=Installing_Gramps_for_Windows_computers]]''' Ubuntu ''' [http://sourceforge.net/projects/gramps/files/Stable/{{version}}/gramps_{{version}}_all.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 (change the filename to match the one you downloaded). sudo dpkg -i gramps_3.4.4-1_all.deb For other distributions, [[ImageFile:Download_linkmacos_200x200.png|150px32px|link=http://sourceforge.net/projects/gramps/files/Stable/{{version}}/gramps-{{version}}.tar.gzInstalling_Gramps_for_macOS_computers]] the source and follow the instructions for [[LinuxFile:Build from sourceBsd daemon.png|32px|link=BSD_platforms]] == Notes ==pages.
[===GitHub Gramps for Desktops Releases===<span id!--github_url template ="1"https://github.com/gramps-project/gramps -->1<:* [{{github_url}}/releases/span>v{{version}} {{version}} version]Backup to :* [{{github_url}}/releases/ Archive of Gramps XML. You will find backup in the Family Tree menu releases] Wiki pages* [[Previous releases 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]]* [[:Category:Versions|Versions on various platforms]]
===Installing Gramps Web for online collaboration===[https://gramps-project.org/blog/web/ Gramps Web] is a frontend and a hosted instance of Gramps Web API * Gramps Web frontend - [https://github.com/gramps-project/gramps-web/releases release history on GitHub] - ([<span id="2">2<https://span>calver.org Calendar Versioning]: Year.Month.Micro)Alternatively, you can click and hold * Gramps Web backend api - [https://github.com/gramps-project/gramps-web-api/releases release history on the disk icon at the top of the window of the mounted disk, and then optionGitHub] -drag to the Applications folder([https://semver. This will create a new folder containing all the files, including the README and NEWSorg Semantic Versioning]: Major.Minor.patch)
[<span id="3">3</span>]Deployments:An alternative independent version is * [httphttps://sourceforgewww.grampsweb.net/projectsorg/portableappsDeployment/files/Gramps%20Portable/ GrampsPortable_{{version_windows_portable}}.paf.exeDocker] (20.3 MB) * [httphttps://portableappswww.comgrampsweb.org/appsLetsEncrypt/education/gramps_portable Portable Gramps from PortableApps.com] includes all dependencies required for Windows. Let''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.'' By Bart.S - '''[http://portableapps.com/blog/84601 Please report issues to the author.s Encrypt and Docker Compose]''' (2012-09-07)
[[Category:Documentation]]