15,534
edits
Changes
no edit summary
<u>[{{github_url}}/releases/download/v{{version_windows_AIO64}}/{{filename_windows_AIO64}}.exe Windows Installer (64-bit) {{version_windows_AIO64}}]</u></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 three two shortcuts are added, please only use the first shortcut, unless requested by a developer.<br>1) ''GrampsAIO'''XX''' ''{{version}}'' {{man menu|<--- Shortcut for everyday use of Gramps}}<br>2) ''GrampsAIO'''XX''' ''{{version}}''-console<br>3) ''GrampsAIO'''XX''' ''{{version}}''-debug}}
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.
== <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].|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}}
|<!-- Distribution -->[[File:Debianopenlogo-32.png]]''' [[Debian]] '''
|<!-- GUI Package manager -->Add/Remove Software
|<!-- Current versions -->Debian 7 ("wheezy") (old stable): Gramps 3.4.0<br>Debian 8 ("jessie")(stable): Gramps 4.1.1<br>Debian 8 ("jessie")(backports): Gramps 4.2.45<br>stretch (testing): Gramps 4.2.45<br>[http://packages.debian.org/sid/gramps sid (unstable)]: Gramps 4.2.45
|<!-- Notes -->[http://packages.debian.org/search?keywords=gramps available versions]
|-
|<!-- Distribution -->[[File:Ubuntu_32x32.png]]''' Ubuntu '''
|<!-- GUI Package manager -->Software Centre
|<!-- Current versions -->Precise (12.04 LTS): Gramps 3.3.1<br>Trusty (14.04 LTS): Gramps: 4.0.3<br>Trusty Backports (14.04 LTS): Gramps: 4.0.4<br>Xenial (16.04 LTS): Gramps: 4.2.2<br>Yakkety (16.10): Gramps: 4.2.3<br>Zesty (Development: 17.04): Gramps: 4.2.45
|<!-- Notes -->[http://packages.ubuntu.com/search?keywords=gramps&searchon=names available versions]
|-
|<!-- Distribution -->'''Linux Mint'''
|<!-- GUI Package manager -->Software Manager
|<!-- Current versions -->Isadora (Gramps 3.2.0-1)<br>Lisa (Gramps 3.3.1-1)<br>Olivia (Gramps 3.4.0-1)<br>Qiana /Rosa 17(Gramps 4.0.3+dfsg-2)<br>Sarah /Serena 18(Gramps 4.2.2~dfsg-1)
|<!-- Notes -->[http://community.linuxmint.com/software/view/gramps available versions]
|-
|<!-- Distribution -->[[ImageFile:Fedora_32x32.png]]''' Fedora '''
|<!-- GUI Package manager -->Add/Remove Software (Gnome)<br>or<br>Software Management (KDE)
|<!-- Current versions -->Rawhide (Gramps 4.2.45)<br>Fedora 25 (Gramps 4.2.45)<br>Fedora 24 (Gramps 4.2.4)<br>Fedora 23 (Gramps 4.2.45)|<!-- Notes -->[https://apps.fedoraproject.org/packages/gramps available versions]|-|<!-- Distribution -->[[Image:Redhat_32x32.png]]''' Redhat '''|<!-- GUI Package manager -->Package Management Tool([https/ Note://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/5/html/Deployment_Guide/ch-graphical-rpm.html pirut])|<!-- Current versions -->|<!-- Notes -->The Fedora and Red Hat Projects were merged on September 22, 2003. See Fedora.
|-
|<!-- 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 Caulron: Gramps 4.2.45<br>Mageia 5.0: Gramps 4.1.3
|<!-- Notes -->[http://mageia.madb.org/package/show/name/gramps Mageia App Db - gramps]
|-
|<!-- Distribution -->''' openSUSE '''
|<!-- GUI Package manager -->[https://en.opensuse.org/YaST_Software_Management YaST]
|<!-- Current versions -->openSUSE Tumbleweed: Gramps 4.2.45<br>openSUSE Leap 42.12: Gramps 4.2.04<br>openSUSE 13.2: Gramps 4.0.4
|<!-- 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' )
|-
|<!-- Distribution -->'''Slackware'''
|<!-- GUI Package manager -->
|<!-- Current versions -->Slackware 14.2: Gramps 3.4.3<br>14.1: Gramps 4.0.3|<!-- Notes -->[http://pkgs.org/search/?keyword=gramps available versions]<br>[https://slackbuilds.org/repository/14.2/misc/gramps/?search=gramps slackbuilds.org]: Gramps 4.2.5
|-
|<!-- Distribution -->'''[https://www.netbsd.org/ NetBSD]'''
|<!-- GUI Package manager -->
|<!-- Current versions -->NetBSD: Gramps 3.4.4
|<!-- Notes -->[http://pkgsrc.se/databases/gramps3 available versions]
|-
|<!-- Distribution -->'''[https://www.freebsd.org/ FreeBSD]'''
|<!-- GUI Package manager -->
|<!-- Current versions -->FreeBSD: Gramps 4.2.34
|<!-- Notes -->[http://portsmon.freebsd.org/portoverview.py?category=science&portname=gramps available versions]
|-
|<!-- Distribution -->'''PC-BSDTrueOS'''
|<!-- GUI Package manager -->
|<!-- Current versions -->PC-BSD: Gramps 3.4.8
|<!-- Notes -->[http://web.pcbsd.org/pc-bsd-is-now-trueos/ 2016/09/01 - PC-BSD is now TrueOS]
|-
|<!-- Distribution -->'''[https://www.openbsd.org/ OpenBSD]'''
|<!-- GUI Package manager -->
|<!-- Current versions -->OpenBSD: Gramps 4.2.35
|<!-- Notes -->[http://openports.se/misc/gramps available versions]
|-
|<!-- Distribution -->'''Arch Linux'''
|<!-- GUI Package manager -->
|<!-- Current versions --> Gramps 4.2.45
|<!-- Notes -->[https://www.archlinux.org/packages/community/any/gramps/ available versions]
|-
== 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. Instructions are given below for a number of distributions.
{{man warn|1=Warningbefore 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]]''' and (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]]
[<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>]
