__NOTOC__{{languages|Download}}== Linux ==[[File:Gramp-Small-background-wiki-2020.jpg|120px|left]]'''Research, organize and share your family tree with Gramps.'''
[[Image:Linux_220x261Gramps is a free software project and community.png|55px|left]] Before upgrading your distribution: Use your '''old version of Gramps''' We strive to [[How_to_make_a_backup#GRAMPS_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]]. <big><u>[http://sourceforge.net/projects/gramps/files/Stable/{{version}}/grampsproduce a genealogy program that is both intuitive for hobbyists and feature-{{version}}complete for professional genealogists.tarIt is a community project, created, developed and governed by genealogists.gz Source]</u> <u>[[Download#Linux distributions|via Distributions]]</u> <u>[[Download#Linux:_Install_latest_version|Latest version (advanced users only)]]</u></big>
{{-}}
{{man note|{{Man menu|Gramps '''Current version: '''{{version}}''' Released: '''{{version-released}}'''}}|For a list of updates see: ''[[Gramps 6.0 Wiki Manual - What's new?|What's new?]]}}
== MS Windows =={{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 [[#1|hardy and portable XML format]].}}
<hr /><span id="linux" style="font-size:120%">Linux</span>[[ImageFile:windows_180x160Linux_220x261.png|128px|left|link=Installing_Gramps_for_Linux_computers]]<big>For Linux, we recommend installing and upgrading Gramps using either [https://wikipedia.org/wiki/Flatpak FlatPak] or [https://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/4 Flatpak doesn’t include the BSDDB database backend.])* A Snap is available from the [https://snapcraft.io/gramps Snap Store].</big>
Before download: Use your '''old version of Grampsmay also be available in the ''' to [[How_to_make_a_backup#GRAMPS_version_3https://wikipedia.3_and_later|backup]org/wiki/List_of_software_package_management_systems package manager] ''' provided by your Family Trees [[Installing_Gramps_for_Linux_computers#1Linux_distributions|[1]distribution]]. However, this is likely to be out-of-date in some popular distributions.
<big>For advanced users, a source package is available:* <u>[http:{{github_url}}/archive/sourceforge.netrefs/projects/gramps/files/Stabletags/v{{version_windows_AIO32version}}/v{{filename_windows_AIO32version}}.exe Windows Installer (32-bit)]</u> <u>[http://sourceforgetar.net/projects/gramps/files/Stable/{{version_windows_AIO64}}/gz Source Package {{filename_windows_AIO64version}}.exe Windows Installer (64-bit)]</u></big>
After downloadInstructions for how to [[Linux: double-click to install GrampsBuild from source|build from source]] are available in our wiki.
Normally{{-}}<hr /><span id="windows" style="font-size:120%">Microsoft Windows</span>[[File:windows_180x160.png|128px|left|link=Installing Gramps for Windows computers]]This executable installer supports Microsoft Windows in versions 8, when you try to load your old Family Tree you can allow it to be upgraded if necessary10, 11 (64-bit Only) and it will be openedlater. However if this fails for any reason, <big>* <u>[{{github_url}}/releases/download/v{{version_windows_AIO64}}/{{filename_windows_AIO64}}.exe Windows Installer (64-bit) {{version_windows_AIO64}}]</u>After download: '''Create''' a new Family Tree and double-click to install Gramps'''Import''' the back-up into this new Tree.
Alternative independent MS Windows version Alternatives to the All-In-One installer include the [[Installing_Gramps_for_Windows_computers#3PortableApps.com|PortableApps.com]] and [3[Installing_Gramps_for_Windows_computers#Chocolatey_NuGet_Package|Chocolatey NuGet Package]]. Advanced users can install Gramps from source using the [[Gramps_for_Windows_with_MSYS2|MSYS2]]build environment.
Final Gramps versions for legacy Windows systems (PortableApps format): Windows 7 64-bit: [https://portableapps.com/downloading/?a=GrampsPortableLegacyWin7&s= Mac OS X s&p=&d=pa&n=Gramps%20Portable&f=GrampsPortableLegacyWin7_5.1.6_Rev_2.paf.exe 5.1.6], Windows 7/8/10 '''32-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=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 [[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-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 [[ImageMac_OS_X:macos_200x200.pngApplication_package|128pxapplication package]] include the [[Installing_Gramps_for_macOS_computers#MacPorts|leftMacPorts]] and [[Installing_Gramps_for_macOS_computers#Homebrew|link=http://sourceforge.net/projects/gramps/files/Stable/{{version_windows_AIO32}}/{{filename_windows_AIO32}}.exeHomebrew]]package managers.
Before download: Use your '''old version of {{man warn|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 See:<br>* 2025 Forum discussion [[#1|[1https://gramps.discourse.group/t/ios-app-named-gramps/6756/4 iOS app named “Gramps”]]]. Read the }}{{-}}<hr /><span id="bsd" style="font-size:120%">BSD platforms</span>[[Mac OS XFile:Application packageBsd daemon.png|128px|before installationleft|link=BSD platforms]] instructions.
Mac OS X 10.5 (Leopard)For BSD, 10.6 (Snow Leopard) we recommend installing and 10.7 (Lion) <big><u>upgrading Gramps using the '''[httphttps://sourceforgewikipedia.net/projects/gramps/files/Stableorg/{{version_Mac}}wiki/Gramps-PPC-{{version_Mac}}-2.dmg IntelList_of_software_package_management_systems package manager]</u> <u>''' provided by your [[http://sourceforge.net/projects/gramps/files/Stable/{{version_Mac}}/Gramps-Intel-{{version_Mac}}-2BSD platforms#BSD_distributions|distribution]].dmg Power PC]</u></big>
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 Advanced users can [[#2Linux:Build from source|[2]build from source]]using the link in the Linux section.
Normally, when you try to load your old Family Tree you Further information 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''' found on the back-uo into this new Tree. == Live CD == [[Image:Download_link.png|150px|left|link=http://sourceforge.net/projects/gramps/files/OldFiles/3.2.5/lgenealogy-6.1-desktop-i386.isoBSD platforms]]'''Linux live CD Demonstration''' [[Linux_Genealogy_CD#Obtaining_the_CD|Obtaining page in the CD]] (727 MB) [[Linux Genealogy CD|Linux Genealogy CD based on Ubuntu 10wiki.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. == Linux 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'''|Synaptic ??|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:hr //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]|}
{{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, '''Create''' a new Family Tree and [[How_to_restore_a_backup|'''Import''' the backup]] into this new Family Tree.}}
{{-}}
<br />
{{-}}
== Linux: Install latest version Notes == If your distribution doesn<span id="1">Backup to '''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 XML''' format when updating. ''Although Gramps manuallyreads and writes '''GEDCOM 5. Instructions are given below for a number of distributions5. {{man warn|1=Warning|2=This should only be attempted by experienced users''' format fluently (because it is the de facto format for genealogical data interchange), and after you have backed up never depend on such a rudimentary format for archiving your Family Treeresearch. GEDCOM cannot store all the intricacies found in Gramps data.'' Always backup with the more robust Gramps XML format.</span>
The version of Gramps that has been included in your distribution will have been tested to work with the components in that distribution[[File:Menubar-FamilyTrees-overview-FamilyTree-Loaded-example-60. 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 properlypng|thumb|right|450px|Menubar - {{man menu|"Family Trees > Make Backup. You might not discover that there is a problem till you have already done some work with the new version of Gramps.."}}]]
If you already have Gramps installed, and you are only making You will find a 'point' upgrade (i[[Gramps_{{man version}}_Wiki_Manual_-_Manage_Family_Trees#Backing_up_a_Family_Tree|{{Man menu|Make Backup.e. from .}}]] option in the {{Man menu|Family Trees}} menu of recent Gramps x.y.z to xversions.y.z+1Alternately, euse [[Gramps_{{man version}}_Wiki_Manual_-_Manage_Family_Trees#Exporting_data|{{Man menu|Export.g. from 3.4.3 to 3.4.4), then it is likely }}]] in the same menu but not certain that Gramps will continue to work. However, if deselect the privacy and filtering options in the change is much greater, especially if it is a major version change (e.g. from 2.y.z Exporter Assistant to 3.y.z), then the danger that it does not work properly is much greateravoid omission of any data.}}
[[ImageSee:Ubuntu_32x32.png]]'''Debian''' and ''' Ubuntu ''' [[http://sourceforge.net/projects/gramps/files/Stable/{{version}}/gramps_{{version}}-1_all.deb|Download the .deb fileHow to make a backup]]. 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, you could try == See also ==* Installer [[Linux:Build from sourceTeam#Package_Maintainers|package maintainers]]
== Notes =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===<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]]