__NOTOC__{{languages|Download}}[[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 warnnote|1=Warning{{Man menu|2=I plan to make some further significant changes to this page, so please donGramps '''Current version: '''{{version}}''' Released: '''{{version-released}}'''}}|For a list of updates see: ''t translate it just yet[[Gramps 6.0 Wiki Manual - What's new?|What's new?]]}}

<span style="color: red">If you are {{man warn|Before upgrading from a previous your distribution|Use your '''earlier version, you must carry out of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees to the [[Download#Upgrading1|upgradehardy and portable XML format]] process. If you do not have a backup, the Gramps developers cannot be responsible for any data loss</span>}}

<hr /><span id="linux" style="colorfont-size: green120%">Linux</span>'''Official support''' Only the '''source code''' on the Linux platform is officially released and supported as [[PortalFile:DevelopersLinux_220x261.png|128px|Gramps developersleft|link=Installing_Gramps_for_Linux_computers]] use <big>For Linux, we recommend installing and test the '''source code''' on that platform, fixing any problems that arise due to upgradesupgrading Gramps using either [https://wikipedia.org/wiki/Flatpak FlatPak] or [https://en.wikipedia. The source release org/wiki/Snap_(software) Snap]:* A Flatpak is intended for available from [https://flathub.org/apps/org.gramps_project.Gramps Flathub]. ([Build_from_source|building 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 source]the [https://snapcraft.io/gramps Snap Store] by packagers and developers. This page describes the Linux packages, MS Windows installers and Mac OS X bundles that have been provided by 'community support' for download and installation by users.</spanbig>

{{TemplateGramps may also be available in the '''[https:download}}//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.

If you already have a Family Tree in Gramps, and you are upgrading to a new version of Gramps, then you must make follow the process below to ensure that you do not run the risk of loosing data.# Use your '''old version of Gramps''' Instructions for how to [[How_to_make_a_backup#GRAMPS_version_3.3_and_laterLinux:Build from source|backupbuild from source]] your Family Tree your Family Trees to GRAMPS XML (you find backup are available 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)our wiki.# '''Uninstall''' your old version of Gramps# '''Install''' the new version of Gramps by following the instructions above# '''Open''' your existing Family tree. Normally, opening just works, and will upgrade your data if needed. If successful, save the backup you took in a safe place

{{-}}<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, 10, 11 (64-bit Only) and later.<big>* <u>[{{github_url}}/releases/download/v{{version_windows_AIO64}}/{{filename_windows_AIO64}}.exe Windows Installer (64-bit) {{version_windows_AIO64}}]</u>After download: '''double-click to install Gramps'''. Alternatives to the All-In case opening or upgrading -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 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=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 existing Family Tree failedbrowser may do this for you automatically). Next, do drag the Gramps application to your application folder and double-click to launch it. Alternatives to the [[Mac_OS_X:Application_package|application package]] include the [[Installing_Gramps_for_macOS_computers#MacPorts|MacPorts]] and [[Installing_Gramps_for_macOS_computers#Homebrew|Homebrew]] package managers.  {{man warn|The Gramps app on Apple’s App Store is in no way affiliated with the followingGramps project.|See:<br>* 2025 Forum discussion [https://gramps.discourse.group/t/ios-app-named-gramps/6756/4 iOS app named “Gramps”]}}{{-}}<hr /><span id="bsd" style="font-size:120%">BSD platforms</span>[[File:Bsd daemon.png|128px|left|link=BSD platforms]] For BSD, we recommend installing and upgrading Gramps using the '''[https://wikipedia.org/wiki/List_of_software_package_management_systems package manager]''' provided by your [[BSD platforms# BSD_distributions|distribution]]. Advanced users can [[Linux:Build from source|build from source]] using the link in the Linux section. Further information can be found on the [[BSD platforms]] page in the wiki.{{-}}<hr /> {{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 Treeand [[How_to_restore_a_backup|'''Import''' the backup]] into this new Family Tree.}}{{-}}<br />{{-}}== Notes ==# <span id="1">Backup to '''Gramps XML''' format when updating. ''Although Gramps reads and writes '''ImportGEDCOM 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 old research. GEDCOM cannot store all the intricacies found in Gramps data.'' Always backup with the more robust Gramps XML data 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 this the {{Man menu|Family TreeTrees}} 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 ==* Installer [[Team#Package_Maintainers|package maintainers]] ===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 and a hosted instance of Gramps Web API * Gramps Web frontend - [https://github.com/gramps-project/gramps-web/releases release history on GitHub] - ([https://calver.org Calendar Versioning]: Year.Month.Micro)* Gramps Web backend api - [https://github.com/gramps-project/gramps-web-api/releases release history on GitHub] - ([https://semver.org Semantic Versioning]: Major.Minor.patch) Deployments:* [https://www.grampsweb.org/Deployment/ Docker] * [https://www.grampsweb.org/LetsEncrypt/ Let's Encrypt and Docker Compose]