23
edits
Changes
m
===The latest released version===
* Version '''GRAMPS''' {{version}} was released. All releases of GRAMPS are available from [https://sourceforge.net/projects/gramps/files/ the download page on SourceForge].
Visit the following page for instructions on:* [[Installation]]* [[Installation#Upgrading_GRAMPS|Upgrading]]* [[3'''Research, organize and share your family tree with Gramps.2 Addons|Addons]] - third-party plugins'''
===Officially supported===* Only the Linux platform Gramps is officially supported as GRAMPS developers use a free software project and test the '''source code''' on community. We strive to produce a genealogy program that platformis both intuitive for hobbyists and feature-complete for professional genealogists. It is a community project, created, fixing any problems that arise due to upgradesdeveloped and governed by genealogists.
===Community supported===*A platform is community supported when users have created an installable version for that platform. Full functionality of GRAMPS is not guaranteed and some components may be disabled. Developers Below are dependent on the community ways to fix any issues that arise. The GRAMPS developers aim to have GRAMPS working install Gramps on all platforms, but have no resources to do specific testing to assure this is some of the case on release of a new version.more popular distributions:
[[Category:Developers/Installation]]
[[Category:Developers/Packaging]]
Linux Mint Logo added
{{languages}}
{{man note| {{PrettytableMan menu|'''Current version: {{version}} Released: 2017-08-01'''}}|''Different data format to the GRAMPS 3.4 series. Full Python 3 support only as Python 2 support dropped. Uses GTK+ 3 GUI. Lot of updates see:.''[[Gramps_4.2_Wiki_Manual_-_What's_new%3F|What's new?]]}}! Platform! GRAMPS{{man warn|Final ''Legacy version: 3.4.9 Released: 2015-04-30|This is the final maintenance release designed for those of you still running gramps with gtk2. The database is common between version 4.0.x (not version 4.1.x and version 4.2.x) and 3.4.x branch, most differences are into interface...''[https://gramps-project.org/2015/04/gramps-3-4-9-released/]}} == Linux == [[File:Linux_220x261.png|128px|left]] 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]]]. <brbig>Release! <u>[[Download#Linux distributions|via Distributions]]</u>! Note <u>[[Download#Linux:_Install_latest_version|Latest version ({{version}}) (advanced users only)]]</u></big>{{-}} == MS Windows == [[File:windows_180x160.png|<!128px|left]] Before download: Use your '''old version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]]. Supports Microsoft Windows in all versions [http://windows.microsoft.com/en-au/windows/lifecycle Vista/7] and later.(''Please note: Python-3.5 and Gtk- Platform 3.18 dropped support for Windows XP not Gramps itself. Gramps can still be run on Windows XP with older versions of those libraries eg:(Gtk-3.16 & Python3.4.4)'') <big><u>[{{github_url}}/releases/download/v{{version_windows_AIO32}}/{{filename_windows_AIO32}}.exe Windows Installer (32-bit) {{version_windows_AIO32}}]</u> <u>[{{github_url}}/releases/download/v{{version_windows_AIO64}}/{{filename_windows_AIO64}}.exe Windows Installer (64-bit) {{version_windows_AIO64}}]</u>Linux</big> After download: double-click to install Gramps. {{man menu|Standard setup is ''English only'' so if using a different language please ensure that you select extra dictionary and language files when asked during the installation process.}} {{man tip|Shortcuts|Once installed one shortcut is placed on the desktop and in the Start menu two shortcuts are added, please only use the first shortcut, unless requested by a developer.<br>1) ''GrampsAIO'''XX''' ''{{version}}'' {{man menu|<!-- GRAMPS- Shortcut for everyday use of Gramps}}<br>Release 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. However if this fails for any reason, '''Create''' a new Family Tree and '''Import''' the back-up into this new Tree. Use the Windows AIO version, please use the download links above. For more information about individual versions, console and debug modes, release notes, etc., look at [[GrampsAIO-4|this page]] (English only). Alternative independent '''Legacy''' MS Windows version [[#3|[3]]]. You may also install using the alternative independent Gramps Chocolatey Package [[#4|[4]]]. == Mac OS X == [[File:macos_200x200.png|128px|left]] Before download: Use your '''old version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]]. Read the [[Mac OS X:Application package|before installation]] instructions. Supports Mac OS X in all versions 10.5 (Leopard) and later. <big><u>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_intel}}.dmg Intel {{version_Mac}}]</u></big>Assorted| <big><u>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_ppc}}.dmg Power PC {{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 [[#2|[2]]]. Normally, when you try to load your old Family Tree you 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''' the back- up into this new Tree. {{man tip|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 [http://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.}} {{-}} == BSD == [[File:Bsd daemon.jpg|128px|left]] 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 [[Installation#Installing_GRAMPS_from_source_code1|Installation from source[1]]]. <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 == [[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..). [[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.{{-}}[[File:Download_link.png|150px|left|link=http://cdimage.ubuntu.com/edubuntu/releases/14.04/release/]]'''Edubuntu 14.04.3''' includes Gramps 4.0.3-1 (For information about Edubuntu [http://www.edubuntu.org/news/14.04.2-release visit]){{-}} === Online Demonstration ===You can also try an online demonstration of Gramps on rollApp:* https://www.rollapp.com/app/grampsSelect '''Launch Online''' then '''Test Drive(Opening/saving files will not be available)''' {{man note|Note |This is a commercial limited trial and not endorsed by the Gramps-project. Beware of third parties having your genealogical data.}}{{-}} == <span id="Linux distributions">Building of GRAMPS from source required</span>Linux and BSD distributions =={{man note|These packages are built and supported by the [https://en.wikipedia.org/wiki/Linux_distribution distros].|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.
{| {{Prettytableprettytable}}! Platform! GRAMPS<br>Release! Download! Note|-style="width: 85pt;" |<!-- Platform -->WindowsDistribution|<!-- GRAMPS<br>Release -->3.2.5GUI Package manager|<!-- Download -->[http://sourceforge.net/projects/gramps/files/Stable/3.2.5/gramps-3.2.5-1.exe/download gramps-3.2.5-1.exe] (7.1 MB)Current versions|<!-- Note -->[[Windows_installer#Installation|Download and install Windows dependencies first]]Notes
|-
|<!-- Platform Distribution -->Windows[[File:Debianopenlogo-32.png]]''' [[Debian]] '''|<!-- GRAMPS<br>Release GUI Package manager -->3.2.5 Development Test 1Add/Remove Software|<!-- Download Current versions -->[httpDebian 7 ("wheezy") (old old stable): Gramps 3.4.0<br>Debian 8 ("jessie")(old stable): Gramps 4.1.1<br>Debian 8 ("jessie")(backports)://nascentGramps 4.2.5<br>Debian 8 ("jessie")(backports-projectsloppy): Gramps 4.2.org/barts/GRAMPSPortable_36<br>Debian 9 ("stretch") (stable): Gramps 4.2.5_Development_Test_15<br>Debian 9 ("stretch")(backports): Gramps 4.paf2.exe GRAMPSPortable_36<br>buster (testing): Gramps 4.2.5_Development_Test_16<br>[http://packages.pafdebian.exeorg/sid/gramps sid (unstable)] (22: Gramps 4.2.6 MB)|<!-- Note Notes -->[http://portableappspackages.comdebian.org/node/25668 Portable GRAMPS for PortableApps.comsearch?keywords=gramps available versions] all in one with no dependencies.('''Under Development''' by Bart.S / '''Please test on Windows and report back to the author.'''(2010-11-24)
|-
|<!-- Platform Distribution -->Windows[[File:Ubuntu_32x32.png]]''' Ubuntu '''|<!-- GRAMPS<br>Release GUI Package manager -->3.1.1Software Centre|<!-- Download Current versions -->Trusty (14.04 LTS): Gramps: 4.0.3<br>Trusty (14.04 LTS): Gramps: 4.2.3 ([httphttps://downloadslaunchpad.ormusnet/~rosco2/+archive/ubuntu/backports Backport])<br>Xenial (16.04 LTS): Gramps: 4.2.2<br>Xenial (16.04 LTS): Gramps: 4.2.info6 ([https:/?path=/launchpad.net/PortableApps&file=GrampsPortable_3~rosco2/+archive/ubuntu/backports Backport])<br>Zesty (17.104): Gramps: 4.12.paf5<br>Zesty (17.exe GrampsPortable_304): Gramps: 4.12.16 ([https://launchpad.paf.exenet/~rosco2/+archive/ubuntu/backports Backport] )<br>Artful (23Development: 17.10): Gramps: 4.2 MB).6|<!-- Note Notes -->[http://wwwpackages.ormusubuntu.infocom/archives/278-Portable-Gramps-Genealogy-in-your-Pocket.html Portable GRAMPS for PortableApps.com by Ormussearch?keywords=gramps&searchon=names available versions] all in one with no dependencies.<!-- FYI: This version has had until until 20101125 a total of 111122 Downloads.-->
|-
|<!-- Platform Distribution -->[[File:Farm-Fresh linux mint.png]]''' Linux Mint'''|<!-- GRAMPS<br>Release GUI Package manager -->Software Manager|<!-- Download Current versions -->17.x(Gramps 4.0.3+dfsg-2)<br>18.x(Gramps 4.2.2~dfsg-1)|<!-- Note Notes -->Install the most current version of Gramps using the following [https://forums.linuxmint.com/viewtopic.php?t=220159 instructions] from the ''Linux Mint Forums''<br><br>[http://community.linuxmint.com/software/view/gramps Old versions available from Linuxmint]
|-
|<!-- Platform Distribution -->Linux[[File:Fedora_32x32.png]]''' Fedora ''' |<!-- GRAMPSGUI Package manager -->Add/Remove Software (Gnome)<br>Release --or<br>AssortedSoftware Management (KDE)|<!-- Download Current versions -->[[Installation#Automatic_download_and_install_of_GRAMPS|Automatic installation]]Rawhide (Gramps 4.2.6)<br>Fedora 27 (Gramps 4.2.6)<br>Fedora 26 (Gramps 4.2.6)<br>Fedora 25 (Gramps 4.2.6)|<!-- Note Notes -->Depends [https://apps.fedoraproject.org/packages/gramps available versions] / Note:The Fedora and Red Hat Projects were merged on version of Linux usedSeptember 22, 2003.
|-
|<!-- Platform Distribution -->Linux'''[https://www.mageia.org/en/ Mageia]'''|<!-- GRAMPS<br>Release GUI Package manager -->Assorted|[https://wiki.mageia.org/en/Installing_and_removing_software drakrpm (or rpmdrake)]|<!-- Download Current versions -->[[Installation#Manual_download_and_install_of_GRAMPS|Manual installation]]Mageia Caulron: Gramps 4.2.5<br>Mageia 5.0: Gramps 4.1.3|<!-- Note Notes -->Depends on version of Linux used[http://mageia.madb.org/package/show/name/gramps Mageia App Db - gramps]
|-
|<!-- Platform Distribution -->''' openSUSE '''|<!-- GRAMPS<br>Release GUI Package manager -->[https://en.opensuse.org/YaST_Software_Management YaST]|<!-- Download Current versions -->openSUSE Tumbleweed: Gramps 4.2.6<br>openSUSE Leap 42.3: Gramps 4.2.4<br>openSUSE Leap 42.2: Gramps 4.2.4|<!-- Note Notes -->[http://software.opensuse.org/package/gramps available versions]<br>See note [http://gramps.1791082.n4.nabble.com/ahnenforschung-familie-ihle-de-td4672224.html#a4672266] : Gramps 4.2 can be installed on Opensuse 13.2 ( if you add the 'openSUSE BuildService - GNOME:Apps' )
|-
|<!-- Platform Distribution -->Linux Live CD'''Slackware'''|<!-- GRAMPSGUI Package manager -->|<br>Release !-- Current versions -->14.2: Gramps 3.4.3<br>14.1: Gramps 4.0.13|<!-- Download Notes -->[http://downloadspkgs.sourceforge.netorg/search/?keyword=gramps/ubuntu804-genealogy40-gramps301-i386.iso ubuntu804-genealogy40-gramps301-i386.isoavailable versions]<br>(730 MB)|<!-- Note -->[[Linux Genealogy CD|Linux Genealogy CD based on Ubuntu 8https://slackbuilds.org/repository/14.2/misc/gramps/?search=gramps slackbuilds.04 (Hardy Heron)]org]: Gramps 4.2.5
|-
|<!-- Platform Distribution -->'''[https://www.netbsd.org/ NetBSD]'''|<!-- GRAMPS<br>Release GUI Package manager -->|<!-- Download Current versions -->NetBSD: Gramps 3.4.4|<!-- Note Notes -->[http://pkgsrc.se/databases/gramps3 available versions]
|-
|<!-- Platform Distribution -->BSD'''[https://www.freebsd.org/ FreeBSD]'''|<!-- GRAMPSGUI Package manager -->|<br>Release !-- Current versions -->3FreeBSD: Gramps 4.2.4|<!-- Download Notes -->[http://portsmon.freebsd.org/portoverview.py?category=science&portname=gramps FreeBSD port]|<!-- Note -->[[BSD page|BSD information]available versions]
|-
|<!-- Platform Distribution -->'''TrueOS'''|<!-- GRAMPS<br>Release GUI Package manager -->|<!-- Download Current versions -->PC-BSD: Gramps 3.4.8|<!-- Note Notes -->[http://web.pcbsd.org/pc-bsd-is-now-trueos/ 2016/09/01 - PC-BSD is now TrueOS]
|-
|<!-- Platform Distribution -->Solaris'''[https://www.openbsd.org/ OpenBSD]'''|<!-- GRAMPS<br>Release GUI Package manager -->3.0.1|<!-- Download Current versions -->[[Solaris page|Solaris platforms]]OpenBSD: Gramps 4.2.6|<!-- Note Notes -->Building of GRAMPS from source required[http://openports.se/misc/gramps available versions]
|-
|<!-- Platform Distribution -->[[File:archlinux-icon-crystal-32.svg]]'''[https://www.archlinux.org/ Arch Linux]'''|<!-- GRAMPS<br>Release GUI Package manager -->|<!-- Download Current versions -->Gramps 4.2.6|<!-- Note Notes -->[https://www.archlinux.org/packages/community/any/gramps/ available versions]
|-
|<!-- Platform Distribution --> Mac OS X'''Gentoo Linux'''|<!-- GRAMPS<br>Release GUI Package manager -->3.2.0|<!-- Download Current versions -->[[Mac OS X MacPorts]]Gramps 4.2.5|<!-- Note Notes -->New and relatively untested (March 2010)[https://packages.gentoo.org/packages/app-misc/gramps available versions]
|-
|<!-- Platform Distribution -->Mac OS X|<!-- GRAMPS<br>Release GUI Package manager -->3.2.5|<!-- Download Current versions -->[[Using GRAMPS on Apple Mac]] (37MB)|<!-- Note Notes -->New and relatively untested (Oktober 2010).
|}
{{-}}
== 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 this use your existing installation to [[How to make a backup|make a Gramps XML backup]]|2=This should only be attempted by experienced users, and after you have backed up your Family Tree.
The version of Gramps that has been included in your distribution will have been tested 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 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 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.}}
=== Debian-based ===
For [[Image:Debianopenlogo-32.png]]'''[[Debian|Debian-based linux distributions]]''' (Which includes [[Image:Ubuntu_32x32.png]]''' Ubuntu ''') [{{github_url}}/releases/v{{version}} 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 python3-gramps_{{version}}-1_all.deb
If you have an error about having unmet dependencies run:
sudo apt-get -f install
to install the dependencies.
==== 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 python3-gramps
that queries the package and gives you info about it.
* 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 python3-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.'''
=== For other distributions ===
For other distributions, [[Image:Download_link.png|150px|link={{github_url}}/releases/v{{version}}]] the source and follow the instructions for [[Linux:Build from source]]
== Notes ==
[<span id="1">1</span>]
Backup to Gramps XML. You will 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. See : [[How to make a backup]]
[<span id="2">2</span>]
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.
[<span id="3">3</span>]
An alternative independent '''Legacy''' version is [http://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ GrampsPortable_{{version_windows_portable}}.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.'' By Bart.S - '''[http://portableapps.com/blog/84601 Please report packaging issues to the author.]''' (2012-09-07)
[<span id="4">4</span>]
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]
== See also ==
* [[Previous releases of Gramps]]
[[Category:Documentation]]
