Difference between revisions of "Download"

From Gramps
Jump to: navigation, search
m (Notes: Revise before segmenting clones into separate installer pages.)
(5.2.1 released)
(30 intermediate revisions by 4 users not shown)
Line 2: Line 2:
 
'''Research, organize and share your family tree with Gramps.'''  
 
'''Research, organize and share your family tree with Gramps.'''  
  
{{man note|{{Man menu|Gramps '''Current version: '''{{version}}''' Released: '''2023-06-29'''}}|For a list of updates see: ''[[Gramps 5.1 Wiki Manual - What's new?|What's new?]]}}  
+
{{man note|{{Man menu|Gramps '''Current version: '''{{version}}''' Released: '''2024-03-24'''}}|For a list of updates see: ''[[Gramps 5.2 Wiki Manual - What's new?|What's new?]]}}  
  
{{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>]].}}
+
{{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]].}}
  
[[File:Linux_220x261.png|128px|left|link=Download#Linux]]
+
<hr />
We recommend installing and upgrading Gramps using the '''[https://wikipedia.org/wiki/List_of_software_package_management_systems package manager]''' provided by your [[Download#Linux distributions|distribution]] or by installing a FlatPak available from [[Download#Flathub|Flathub]].
+
<span style="font-size:120%">Linux</span>
 +
[[File:Linux_220x261.png|128px|left|link=Installing_Gramps_for_Linux_computers]]
 +
For Linux, we recommend installing and upgrading Gramps using the '''[https://wikipedia.org/wiki/List_of_software_package_management_systems package manager]''' provided by your [[Installing_Gramps_for_Linux_computers#Linux_distributions|distribution]] or by installing a [https://wikipedia.org/wiki/Flatpak FlatPak] available from [[Installing_Gramps_for_Linux_computers#Flathub|Flathub]].
  
 
For advanced users, a source package and Debian package are available:
 
For advanced users, a source package and Debian package are available:
Line 13: Line 15:
 
* <u>[{{github_url}}/archive/refs/tags/v{{version}}/v{{version}}.tar.gz Source Package {{version}}]</u>
 
* <u>[{{github_url}}/archive/refs/tags/v{{version}}/v{{version}}.tar.gz Source Package {{version}}]</u>
 
* <u>[{{github_url}}/releases/download/v{{Version Linux Debian}}/gramps_{{Version Linux Debian}}-1_all.deb Debian Package {{Version Linux Debian}}]</u></big>
 
* <u>[{{github_url}}/releases/download/v{{Version Linux Debian}}/gramps_{{Version Linux Debian}}-1_all.deb Debian Package {{Version Linux Debian}}]</u></big>
Instructions for how to [[Linux:Build from source|build from source]] are available in the wiki.
+
Instructions for how to [[Linux:Build from source|build from source]] or [[Installing_Gramps_for_Linux_computers#Debian_package|install a Debian package]] are available in the wiki.
 +
 
 
{{-}}
 
{{-}}
 
<hr />
 
<hr />
 
+
<span style="font-size:120%">Microsoft Windows</span>
[[File:windows_180x160.png|128px|left|link=Download#MS_Windows]]
+
[[File:windows_180x160.png|128px|left|link=Installing Gramps for Windows computers]]
This installer supports Microsoft Windows in all versions [http://windows.microsoft.com/en-au/windows/lifecycle Vista/7] and later.
+
This executable installer supports Microsoft Windows in versions 8, 10, 11 (64-bit Only) and later.
 
<big>
 
<big>
 
* <u>[{{github_url}}/releases/download/v{{version_windows_AIO64}}/{{filename_windows_AIO64}}.exe Windows Installer (64-bit) {{version_windows_AIO64}}]</u>
 
* <u>[{{github_url}}/releases/download/v{{version_windows_AIO64}}/{{filename_windows_AIO64}}.exe Windows Installer (64-bit) {{version_windows_AIO64}}]</u>
 
* <u>[{{github_url}}/releases/download/v{{version_windows_AIO32}}/{{filename_windows_AIO32}}.exe Windows Installer (32-bit) {{version_windows_AIO32}}]</u></big>
 
* <u>[{{github_url}}/releases/download/v{{version_windows_AIO32}}/{{filename_windows_AIO32}}.exe Windows Installer (32-bit) {{version_windows_AIO32}}]</u></big>
 
After download: '''double-click to install Gramps'''.
 
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.
 +
 +
Older versions available for  (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])
 
{{-}}
 
{{-}}
 
<hr />
 
<hr />
 
+
<span style="font-size:120%">Apple macOS</span>
[[File:macos_200x200.png|128px|left|link=Download#Mac_OS_X]]
+
[[File:macos_200x200.png|128px|left|link=Installing Gramps for macOS computers]]
Before downloading read the [[Mac OS X:Application package|before installation]] instructions.
+
Before downloading read the [[Mac_OS_X:Application_package#Before_installation|before installation]] instructions.
 
<big>
 
<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_intel}}.dmg Intel {{version_Mac}}]</u>
Line 33: Line 40:
 
</big>
 
</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.
 
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.
 
{{-}}
 
{{-}}
 
<hr />
 
<hr />
 +
<span style="font-size:120%">BSD platforms</span>
 +
[[File:Bsd daemon.png|128px|left|link=BSD platforms]]
  
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 back-up]] into this new Tree.
+
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]].
{{-}}
 
<br />
 
 
 
== Linux ==
 
  
[[File:Linux_220x261.png|128px|left|link=Download#Linux]]
+
Advanced users can [[Linux:Build from source|build from source]] using the link in the Linux section.
  
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>]].  
+
Further information can be found on the [[BSD platforms]] page in the wiki.
 
 
 
 
 
 
<big>
 
<u>[[Download#Linux distributions|via Distributions]]</u>
 
&nbsp;&nbsp;&nbsp;&nbsp;
 
<u>[[Download#Flathub|via Flathub]]</u>
 
&nbsp;&nbsp;&nbsp;&nbsp;
 
<u>[[Download#Linux:_Install_latest_version|Latest version ({{version}}) (advanced users only)]]</u></big>
 
 
{{-}}
 
{{-}}
 +
<hr />
  
== MS Windows ==
+
{{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.}}
[[File:windows_180x160.png|128px|left|link=Download#MS_Windows]]
 
 
 
Before downloading the All-In-One software installer bundle for Windows: 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>]].
 
 
 
This installer supports Microsoft Windows in all versions [http://windows.microsoft.com/en-au/windows/lifecycle Vista/7] and later. The 64-bit versions of Windows allow more efficient access to more resources.
 
 
 
(''Please note: Gramps prefers the Python-3.5 and Gtk-3.18 libraries and newer. Those libraries have dropped support for Windows XP. But Gramps can still be run on Windows XP with earlier library versions, i.e., Python3.4.4 and Gtk-3.16'')
 
 
 
<big>
 
*<u>[{{github_url}}/releases/download/v{{version_windows_AIO64}}/{{filename_windows_AIO64}}.exe Windows Installer (64-bit) {{version_windows_AIO64}}]</u>
 
*<u>[{{github_url}}/releases/download/v{{version_windows_AIO32}}/{{filename_windows_AIO32}}.exe Windows Installer (32-bit) {{version_windows_AIO32}}]</u></big>
 
<!-- preserve in case an installer rebuild is needed in the future
 
{{man note|''The {{version_windows_AIO64}} and {{version_windows_AIO64}}-2 installers are the '''same version of the Gramps program'''. |Only the compilation of the installer was changed. The initial Windows installer was quickly recalled so that the 'dash two' update could restore some omitted dependency items.''}}
 
-->
 
 
 
After download: '''double-click to install Gramps'''. <br>By default: new releases will be added in a new directory and earlier installations of Gramps will ''not'' be overwritten; the language will be a [[#Missing_other_languages|mix of British and US English]].
 
 
 
{{man tip|Shortcuts|During installation, one shortcut is placed on the desktop and two shortcuts are added the Start menu. <br>''Please only use the 'console' secondary shortcut when performing diagnostics requested by a developer.''<br>1) ''GrampsAIO'''XX''' ''{{version}}''      {{man menu| &larr; for normal use of Gramps}}<br>2) ''GrampsAIO'''XX''' ''{{version}}''-console}}
 
 
 
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 back-up]] into this new Tree.
 
 
 
Use the Windows AIO (All-In-One) version, please use the download links above. For more information about individual versions, console and debug modes, release notes, etc., look at [[GrampsAIO cx freeze-based|this page]] (English only). Or, you might want to look at the description of what is meant by an [[All_In_One_Gramps_Software_Bundle_for_Windows|All In One Bundle.]]
 
 
 
=== Alternative independent installation ===
 
[[File:Gramps-release.png|left]]
 
If needed, there are alternatives to the All-In-One installer.
 
 
 
==== PortableApps.com ====
 
[[File:PortableApps_Gramps_Splash.png|right|thumb|450px|When launching the PortableApps fork of Gramps, this splash screen appears.]]
 
A [https://portableapps.com/apps/education/gramps_portable '''PortableApps''' version] will run from an external device without the requirement of installing on the OS drive. PortableApps installations are <b><i>not</i></b> for touchscreen-based mobile devices. They just allow the application to run from external storage, USB thumbdrives.
 
 
 
You can download the '''{{Version_windows_portable}} Gramps Portable version''' from:
 
* the [https://portableapps.com/apps/education/gramps_portable Gramps Portable project] page in their [https://portableapps.com/apps/education/ Education] category. On 64bit systems, the {{Version_windows_portable}} version will install but 32bit systems will install the legacy GrampsPortable 5.1.5 version. See the [https://portableapps.com/comment/254354#comment-254354 PortableApps notice] for more details.
 
 
 
Note that '''PortableApps.com''' also has a Legacy 3.4.9 version of Gramps available -- although it is not recommended for general use; just for recovering older format databases.
 
* [http://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ GrampsPortable_3.4.9.paf.exe] (29.0 MB)
 
 
 
[http://portableapps.com/apps/education/gramps_portable Portable Gramps from PortableApps.com] includes all dependencies required for Windows. ''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.'' '''[https://portableapps.com/forums/support/education Please report packaging issues here]'''
 
 
 
==== Chocolatey NuGet Package ====
 
You may also install using the alternative independent Gramps Chocolatey NuGet Package
 
 
 
Chocolatey NuGet is a Machine Package Manager, somewhat like apt-get, but built with Windows in mind.
 
 
 
* [https://chocolatey.org/packages/gramps/ Gramps Chocolatey Package]
 
 
 
==== Gramps for Windows with MSYS2 ====
 
 
 
How to use [https://www.msys2.org/ MSYS2] to run latest Gramps development version from source in 64bit Windows.
 
 
 
* [[Gramps for Windows with MSYS2]]
 
 
 
 
{{-}}
 
{{-}}
 
+
<br />
=== Missing other languages ===
 
[[File:Microsoft Window Gramps AIO Installer Choose Components-Selection-51.png|right|thumb|450px|Microsoft Window Gramps AIO Installer Choose Components-Selection window.]]
 
The default Gramps AIO installer will embed the US dialect of English for the interface with the British spellcheck dictionary.
 
 
 
If you prefer a different language (or spell with the US or Australian dialects of English), please ensure that you pay special attention to the Choose Components phase of the installation.
 
 
 
To install a language other than English, select from both the '''Translations''' ''and'' '''Dictionaries''' during the Choose Components phase of the installation.
 
 
 
Even your primary language is installed by default, you might anticipate the need to spellcheck Notes in other than the British dialect of English. Be certain to select the appropriate languages from '''Dictionaries'''. Gramps will not access your Operating System's native dictionary.
 
 
 
There is no simple facility for adding interface or dictionary languages after installation.
 
{{-}}
 
 
 
<span id="Mac OS X><!-- backward compatibility hyperlinking anchor-->
 
 
 
== macOS ==
 
</span>
 
[[File:macos_200x200.png|128px|left|link=Download#Mac_OS_X]]
 
 
 
Before downloading the ready-to-run stand-alone bundle: 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>]]. Read the [[Mac OS X:Application package|before installation]] instructions.
 
 
 
Tested for compatibility with Apple macOS/Mac OS X versions 10.13 ([https://en.wikipedia.org/wiki/MacOS_version_history#Version_10.13:_%22High_Sierra%22 High Sierra]) through 14 ([https://en.wikipedia.org/wiki/MacOS_version_history#Version_14:_%Sonoma%22 Sonoma]). ''Help determining your Operating System version can be found in the [https://support.apple.com/en-us/HT201260 HT201260 Apple Support article.]''
 
 
 
<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. (For Apple Mac OS X, alternatively, you can click and hold on the disk icon at the top of the window of the mounted disk, and then option-drag to the Applications folder. This will create a new folder containing all the files, including the README and NEWS.)
 
 
 
 
 
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 back-up]] into this new Tree.
 
 
 
=== Alternative independent installation ===
 
[[File:Gramps-release.png|left]]
 
Alternatively, Gramps can also be built and installed on macOS using MacPorts.
 
 
 
{{-}}
 
==== MacPorts ====
 
 
 
MacPorts is a package manager for Apple Mac.
 
 
 
* [[Mac_OS_X:Build_from_source:MacPorts|MacPorts]]
 
 
 
Why use the version from MacPorts?  Certain plugins or add-ons require additional supporting software in order to operate.  With MacPorts, you can install such software easily (most of the time; there could be exceptions).  With the official .dmg installer, installing such additional software is more difficult or impossible.
 
 
 
The [[Addon:Prerequisites_Checker_Gramplet|Prequisites Checker]] can identify if any add-ons have been installed that require such additional software.
 
 
 
{{-}}
 
 
 
==== Homebrew ====
 
 
 
The macOS application bundle can also be installed via the Homebrew package manager as a cask. Note that this is *not* a Homebrew build, it is a repackaging of the same Gramps.app provided in the above dmg. It does not depend on or use any of the Homebrew-built libraries.
 
 
 
 
 
[https://wikipedia.org/wiki/Homebrew_(package_manager) Homebrew] is an open-source package manager for macOS (and Linux).
 
 
 
See https://github.com/homebrew/
 
 
 
 
 
{{-}}
 
 
 
=== Adding additional Spell Checking languages on macOS ===
 
{{man tip|[[Mac_OS_X:Application_package#Dictionaries|Spell Checking:]]|Gramps uses a different spell checker than the one provided by Mac OS X, with different spelling dictionary requirements. We can't easily provide dictionaries for all of the supported languages in the bundle, but they're easily downloaded from [https://extensions.openoffice.org/ OpenOffice.org's website]. Download the language you want and save it, then navigate to the download in Finder. Most browsers have a downloads window that offers "Show in Finder" in its context menu. Change the file extension from <tt>oxt</tt> to <tt>zip</tt>, then from the context menu select '''Open with... Archive Utility''' to decompress it. In the decompressed folder or perhaps in a subfolder you'll find the dictionary files in pairs, <tt>foo.aff</tt> and <tt>foo.dic</tt>. Some languages have more than one pair with a README file to explain why. Select a pair and copy it to /Library/Dictionaries (you'll have to authenticate with an administrator id and password), and if 'foo' isn't already a language or locale code, make it one. For example, the French package includes several pairs with names like <tt>fr-moderne.aff</tt> and <tt>fr-moderne.dic</tt>. The spell checker doesn't recognize those names, so when you copy them to /Library/Dictionaries you must rename them to <tt>fr.aff</tt> and <tt>fr.dic</tt> or <tt>fr_FR.aff</tt> and <tt>fr_FR.dic</tt>. You can have more than one dictionary pair installed if you use several languages, but one '''must''' match the language you use for Gramps or spell checking won't be enabled at all.}}
 
 
 
{{-}}
 
 
 
== <span id="Linux distributions"></span>Linux and BSD distributions ==
 
{{man note|These packages are built and supported by the [https://en.wikipedia.org/wiki/Linux_distribution distros].|If your 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.
 
 
 
Below are ways to install Gramps on some of the more popular distributions:
 
 
 
{| {{prettytable}}
 
!style="width: 85pt;" | Distribution
 
!GUI Package manager
 
!Current versions
 
!Notes
 
|-
 
|<!-- Distribution        -->[[File:Debianopenlogo-32.png|link=https://packages.debian.org/search?keywords=gramps]]''' [[Debian]] '''
 
|<!-- GUI Package manager -->Add/Remove Software
 
|<!-- Current versions    -->
 
* Debian 10 ("buster") (old stable): Gramps 5.0.1 <!--  https://wiki.debian.org/LTS Debian LTS support for Debian 9 "buster from August 1st, 2022 to June 30th, 2024  -->
 
* Debian 10 ("buster")([https://packages.debian.org/buster-backports/gramps backports]) (stable): Gramps 5.1.2
 
* Debian 11 ("bullseye")(stable): Gramps 5.1.3
 
* 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
 
* trixie (testing): ([https://packages.debian.org/source/trixie/gramps  Gramps 5.1.6])
 
* [http://packages.debian.org/sid/gramps sid (unstable)]: Gramps 5.1.6
 
|<!-- Notes              -->[http://packages.debian.org/search?keywords=gramps available versions]
 
|-
 
|<!-- Distribution        -->[[File:Ubuntu_32x32.png]] '''[https://ubuntu.com/ Ubuntu]'''
 
|<!-- GUI Package manager -->Software Centre
 
|<!-- Current versions    -->
 
* Bionic Beaver (18.04 LTS): Gramps: 5.1.2
 
* Focal (20.04 LTS): Gramps: 5.1.3
 
* Hirsute (21.04): Gramps: 5.1.3
 
* Impish (21.10): Gramps: 5.1.4
 
* Jammy (Development: 22.04): Gramps: 5.1.5
 
|<!-- Notes              -->[http://packages.ubuntu.com/search?keywords=gramps&searchon=names available versions]/ (Also see: [https://launchpad.net/~rosco2/+archive/ubuntu/backports Backports])
 
|-
 
|<!-- Distribution        -->[[File:Farm-Fresh linux mint.png]]''' [https://www.linuxmint.com/ Linux Mint]'''
 
|<!-- GUI Package manager -->Software Manager
 
|<!-- Current versions    -->
 
* 19.x(Gramps 4.2.8) <!-- EOL April 2023 -->
 
* 20.x(Gramps 5.1.2) <!-- EOL April 2025 -->
 
|<!-- Notes              -->
 
* Use the "Software Manager" to install a recent version.
 
* Manually install the most current version of Gramps using the following [https://forums.linuxmint.com/viewtopic.php?t=220159 instructions] from the ''Linux Mint Forums''
 
* [http://community.linuxmint.com/software/view/gramps Old versions available from Linuxmint]
 
|-
 
|<!-- 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 5.1.5)
 
* Fedora 38 (Gramps 5.1.6)
 
* Fedora 39 (Gramps 5.1.6)
 
* Fedora 40 (Gramps 5.1.6)
 
|<!-- Notes              -->[https://koji.fedoraproject.org/koji/packageinfo?packageID=1969 available versions]
 
|-
 
|<!-- 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.mageia.org/package/show/name/gramps/release/cauldron/ Caulron]: Gramps 5.1.5
 
* Mageia 8.0: Gramps 5.1.3
 
|<!-- Notes              -->[http://mageia.madb.org/package/show/name/gramps Mageia App Db - gramps]
 
|-
 
|<!-- 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 5.1.6
 
* openSUSE Leap 15.4: Gramps 4.2.8 <!-- is expected to be maintained until 2023-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
 
|-
 
|<!-- Distribution        -->[[File:Slackware-distribution-icon.jpg|32px]] '''[http://www.slackware.com/ Slackware]'''
 
|<!-- GUI Package manager -->
 
|<!-- Current versions    -->
 
* 15.0: Gramps 5.1.2 - [https://slackbuilds.org/repository/15.0/misc/gramps/?search=gramps slackbuilds.org]
 
* 14.2: Gramps 5.1.2 - [https://slackbuilds.org/repository/14.2/misc/gramps/?search=gramps slackbuilds.org]<!-- EOL 2024-01-01 -->
 
* 14.2: Gramps 4.2.6<!-- EOL 2024-01-01 -->
 
* 14.1: Gramps 4.0.3<!-- EOL 2024-01-01 -->
 
|<!-- Notes              -->[https://pkgs.org/search/?q=gramps available versions]
 
|-
 
|<!-- 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 5.1.6
 
|<!-- Notes              -->[https://archlinux.org/packages/extra/any/gramps/ available versions]
 
|-
 
|<!-- Distribution        -->[[File:Gentoo-distribution-icon.png|32px]]'''[https://gentoo.org Gentoo Linux]'''
 
|<!-- GUI Package manager -->
 
|<!-- Current versions    -->
 
* Gramps 5.1.6
 
* Gramps 5.1.6 (testing)
 
|<!-- Notes              -->[https://packages.gentoo.org/packages/app-misc/gramps available versions]
 
|-
 
|<!-- Distribution        -->'''[https://www.netbsd.org/ NetBSD]'''
 
|<!-- GUI Package manager -->[https://cdn.netbsd.org/pub/pkgsrc/current/pkgsrc/index.html pkgsrc] ([https://cdn.netbsd.org/pub/pkgsrc/current/pkgsrc/databases/index.html databases])
 
|<!-- Current versions    -->
 
* NetBSD: [http://pkgsrc.se/databases/gramps5 Gramps 5.1.6nb1]
 
|<!-- Notes              --> [https://cdn.netbsd.org/pub/pkgsrc/current/pkgsrc/databases/gramps5/index.html available 5.x.x versions]
 
|-
 
|<!-- Distribution        -->'''[https://www.freebsd.org/ FreeBSD]'''
 
|<!-- GUI Package manager --> [https://ports.freebsd.org/cgi/ports.cgi ports.freebsd.org]
 
|<!-- Current versions    -->
 
* FreeBSD: Gramps [https://cgit.freebsd.org/ports/tree/science/gramps 5.1.6]
 
* FreshPorts: Gramps  [https://www.freshports.org/science/gramps/ 5.1.6]
 
|<!-- Notes              --> [https://ports.freebsd.org/cgi/ports.cgi?query=gramps available versions]
 
|-
 
|<!-- Distribution        -->'''[https://www.openbsd.org/ OpenBSD]'''
 
|<!-- GUI Package manager -->[https://openbsd.app/ OpenBSD.app]
 
|<!-- Current versions    -->
 
* OpenBSD: Gramps 5.1.6
 
|<!-- Notes              -->[https://openbsd.app/?search=gramps available versions]<br /> openports.se [https://openports.se/ closed on 30 Jan 2023]
 
|-
 
|<!-- Distribution        -->
 
|<!-- GUI Package manager -->
 
|<!-- Current versions    -->
 
|<!-- Notes              -->
 
|}
 
 
 
 
 
{{-}}
 
 
 
== Linux: 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 manually.
 
 
 
{{man warn|1=Warning before attempting to install the latest Gramps version, use your existing installation to [[How to make a backup|make a Gramps XML backup]]|2=Software updates should only be attempted by experienced users, and after having backed up your data... specifically, your Family Trees.
 
 
 
The version of Gramps that has been included in your distribution will have been tested to work with the components in that distribution. When trying to install a different version of Gramps, there is a possibility that the components needed for the new version of Gramps will not be available for your distribution Or, that the components are available but don't work properly. Such problems might not discovered until after you have already done some work with the new version of Gramps.
 
 
 
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 5.1.3 to 5.1.5), then it is probable that Gramps will continue to work. However, if the change is much greater, especially if it is a major version change (e.g., from 4.y.z to 5.y.z), then the chance that of incompatibilities is much greater.}}
 
 
 
=== Debian-based ===
 
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.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].
 
 
 
{{man note|Please use your existing installation to backup your database before proceeding.|Also, it is a good idea to [[Gramps_5.1_Wiki_Manual_-_Manage_Family_Trees#Converting_a_BSDDB_Family_Tree_to_SQLite|convert your database to SQLite]] even though there is currently BSDDB3 support in the {{Version Linux Flatpak}} Flatpak.}}
 
 
 
First set up Flatpak and the Flathub repository on your system, there are instructions for various distributions at https://flatpak.org/setup/
 
 
 
Second, you can 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 for a system wide installation if you have sudo privileges:
 
 
 
flatpak install flathub org.gramps_project.Gramps
 
 
 
 
 
 
{{-}}
 
{{-}}
 
=== For other distributions ===
 
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]]
 
 
== BSD ==
 
 
[[File:Bsd daemon.png|128px|left|link=Download#BSD]]
 
 
Before upgrading your distribution: Use your '''old version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].
 
 
<big>
 
<u>[[Download#Linux and BSD distributions|via Distributions]]</u>
 
&nbsp;&nbsp;&nbsp;&nbsp;
 
<u>[[Download#Linux:_Install_latest_version|Latest version (advanced users only)]]</u></big>
 
 
 
See also:
 
* [[BSD platforms]]
 
{{-}}
 
 
== 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.1.4 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 ==
 
== 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>  
 
<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-example-50.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.  
 
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.  
Line 414: Line 69:
  
 
== See also ==
 
== See also ==
GitHub Releases <!--github_url template = https://github.com/gramps-project/gramps -->
+
* 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/v{{version}} {{version}} version]
 
:* [{{github_url}}/releases/ Archive of Gramps releases]  
 
:* [{{github_url}}/releases/ Archive of Gramps releases]  
Line 420: Line 80:
 
* [[Previous releases of Gramps]]
 
* [[Previous releases of Gramps]]
 
* [[:Category:Versions|Versions on various platforms]]  
 
* [[: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 and Docker Compose]
 +
  
 
[[Category:Documentation]]
 
[[Category:Documentation]]

Revision as of 00:46, 25 March 2024

Research, organize and share your family tree with Gramps.

Gramps-notes.png
Gramps Current version: 5.2.2 Released: 2024-03-24

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 the package manager provided by your distribution or by installing a FlatPak available from Flathub.

For advanced users, a source package and Debian package are available:

Instructions for how to build from source or install a Debian package are available in the 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.

Older versions available for (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.


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 for a hosted instance of Gramps