Difference between revisions of "Download"

From Gramps
(Page completely re-done to emphasise user download rather than developer (and to use a template))
 
(696 intermediate revisions by 31 users not shown)
Line 1: Line 1:
−
__NOTOC__
+
{{languages|Download}}
−
{{languages}}
+
[[File:Gramp-Small-background-wiki-2020.jpg|120px|left]]
−
<span style="color: red">
+
'''Research, organize and share your family tree with Gramps.'''
−
If you are upgrading from a previous version, you must carry out the [[Download#Upgrading|upgrade]] process. If you do not have a backup, the Gramps developers cannot be responsible for any data loss</span>
 
  
−
<span style="color: green">
+
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.
−
'''Official support''' Only the '''source code''' on the Linux platform is officially released and supported as [[Portal:Developers|Gramps developers]] use and test the '''source code''' on that platform, fixing any problems that arise due to upgrades. The source release is intended for [[Build_from_source|building from source]] 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.
+
{{-}}
−
</span>
+
{{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?]]}}
  
−
{{Template:download}}
+
{{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]].}}
  
−
== Upgrading ==
+
<hr />
 +
<span id="linux" style="font-size:120%">Linux</span>
 +
[[File:Linux_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>
  
−
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.
+
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.
−
# Use your '''old version of Gramps''' to [[How_to_make_a_backup#GRAMPS_version_3.3_and_later|backup]] your Family Tree your Family Trees to GRAMPS XML (you 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).
 
−
# '''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
 
  
−
In case opening or upgrading your existing Family Tree failed, do the following:
+
For advanced users, a source package is available:
−
# '''Create''' a new Family Tree
+
* <u>[{{github_url}}/archive/refs/tags/v{{version}}/v{{version}}.tar.gz Source Package {{version}}]</u>
−
# '''Import''' your old Gramps XML data in this Family Tree
+
 
 +
Instructions for how to [[Linux:Build from source|build from source]] are available in our wiki.
 +
 
 +
{{-}}
 +
<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-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 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 [[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 Gramps 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 Tree and [[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 '''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 ==
 +
* 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]
  
 
[[Category:Documentation]]
 
[[Category:Documentation]]
−
[[Category:Developers/Installation]]
 
−
[[Category:Developers/Packaging]]
 

Latest revision as of 03:08, 14 June 2026

Gramps-config-language.png Languages: 

English  • čeština  • Deutsch  • español  • français  • עברית  • italiano  • Nederlands  • polski  • português  • русский  • slovenčina  • Türkçe  • 中文

Gramp-Small-background-wiki-2020.jpg

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-notes.png
Gramps Current version: 6.0.8 Released: 2026-04-09

For a list of updates see: What's new?

Gnome-important.png
Before upgrading your distribution

Use your earlier version of Gramps to backup your Family Trees to the hardy and portable XML format.

Linux

Linux 220x261.png

For Linux, we recommend installing and upgrading Gramps using either FlatPak or Snap:

Gramps may also be available in the package manager provided by your distribution. However, this is likely to be out-of-date in some popular distributions.

For advanced users, a source package is available:

Instructions for how to build from source are available in our wiki.


Microsoft Windows

Windows 180x160.png

This executable installer supports Microsoft Windows in versions 8, 10, 11 (64-bit Only) and later.

After download: double-click to install Gramps.

Alternatives to the All-In-One installer include the PortableApps.com and Chocolatey NuGet Package. Advanced users can install Gramps from source using the MSYS2 build environment.

Final Gramps versions for legacy Windows systems (PortableApps format): Windows 7 64-bit: 5.1.6, Windows 7/8/10 32-bit: 5.1.5, Windows XP/Vista: 3.4.9

Apple macOS

Macos 200x200.png

Before downloading read the before installation instructions.

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 application package include the MacPorts and Homebrew package managers.

Gnome-important.png
The Gramps app on Apple’s App Store is in no way affiliated with the Gramps project.

See:
* 2025 Forum discussion iOS app named “Gramps”


BSD platforms

Bsd daemon.png

For BSD, we recommend installing and upgrading Gramps using the package manager provided by your distribution.

Advanced users can build from source using the link in the Linux section.

Further information can be found on the BSD platforms page in the wiki.

Tango-Dialog-information.png
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 backup into this new Family Tree.




Notes

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.

Menubar - "Family Trees > Make Backup..."

You will find a Make Backup... option in the Family Trees menu of recent Gramps versions. Alternately, use 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 Linux 32x32.png, Windows 32x32.png,Macos 200x200.png and Bsd daemon.png pages.

GitHub Gramps for Desktops Releases

Wiki pages

Installing Gramps Web for online collaboration

Gramps Web is a frontend and a hosted instance of Gramps Web API

Deployments:

Retrieved from "https://gramps-project.org/wiki/index.php?title=Download&oldid=131373"