__NOTOC__{{languages}}==Easy download and install of GRAMPS 2.2.6Linux ==Before downloading, check if the version of GRAMPS in your distribution is not current:* Debian, (K,X,Edu)Ubuntu, Mepis, Suse: <code>apt-get install gramps</code>* Fedora: <code>yum install gramps</code>
==Live CD==If you are interested in GRAMPS, but afraid to actually install it or unable to install it (not your PC, windows, no internet at home, work laptop, ...), try out our live cd: [[Linux Genealogy CD]]. It does not install on the hard disk and contains a collection of open source, free, genealogy programs. You can install [httpImage://ubuntuLinux_220x261.com Ubuntu 6.06 LTSpng|128px|left]] and GRAMPS from the CD anytime you like.
==Upgrading to latest version==If Before upgrading your distribution: Use your '''old version of GRAMPS is not current, some users offer up Gramps''' to date packages for some distributions:[[How_to_make_a_backup#GRAMPS_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].
* '''Ubuntu''': On sourceforge, <big><u>[[http://sourceforge.net/project/showfiles.php?group_id=25770 downloadDownload#Linux distributions|via Distributions] gramps_zzz.deb and gramps-help_zzz.deb, and install with your package manager.* '''SuSE''': Richard Bos has been providing the GRAMPS releases for SuSE's apt repository. They are always last release in [http://software.opensuse.org/download/home:/rbos/ his repository]. See also [http:<//www.suseforums.net/index.php?s=22f80a050a1e3cffffd590db0813dea9u>&showtopic=28727nbsp;&pid=152093nbsp;&st=0nbsp;&#entry152093. this forum entry].nbsp;* '''Mandriva''': Packages for Mandriva are available for use with urpmi from <u>[[httpDownload#Linux://seerofsouls.com/ SeerOfSouls.com].* '''Fedora''': The alternative to installing from source _Install_latest_version|Latest version (described below{{version}}) is to build a package from an rpm spec file, or install a binary from fedora testing.* '''Debian''': the latest version is installed directly into unstable and can be upgraded from your package manager. Testing is updated 10 days later (except near a new stable releaseadvanced users only).]]</u></big>{{-}}
''Note: Some Linux distributions may have a slightly different way to download and install packages for GRAMPS. Please read the installation instructions specific to your distribution before downloading.''== MS Windows ==
In all other cases, you must [http[Image://sourceforgewindows_180x160.net/project/showfiles.php?group_id=25770 downloadpng|128px|left]] the source package zzz.tar.gz, and install GRAMPS manually. See below for details.
==Windows, BSD, MacOs, Solaris==For Windows, there is an experimental Before download: Use your '''old version of Gramps''' to [[How_to_make_a_backup#GRAMPS_version_3.3_and_later|backup]] your Family Trees [[Windows installer#1|[1]]]. For more recent versions of GRAMPS in Windows, you need to wait untill a new installer is made available.
For BSD, MacOS, Solaris there are experimental install instructions below<big><u>[http://sourceforge.net/projects/gramps/files/Stable/{{version_windows_AIO32}}/{{filename_windows_AIO32}}.exe Windows Installer (32-bit) {{version_windows_AIO32}}]</u> <u>[http://sourceforge.net/projects/gramps/files/Stable/{{version_windows_AIO64}}/{{filename_windows_AIO64}}.exe Windows Installer (64-bit) {{version_windows_AIO64}}]</u></big>
==Gnome and KDE==You can use both, but GRAMPS fits in better with GNOME. For KDE there are some minor issues due After download: double-click to some (GTK) issues outside of GRAMPS. Check the [[KDE page]] to know what these problems might beinstall Gramps.
=Additional software GRAMPS Normally, when you try to load your old Family Tree you can benefit from=GRAMPS does not rely on the following programsallow it to be upgraded if necessary, howeverand it will be opened. However if this fails for any reason, having them will increase your productivity:'''Create''' a new Family Tree and '''Import''' the back-up into this new Tree.
* '''Gnome-print''': It adds the ability to directly print, to preview, and to generate fully internationalized PS and PDF output. At this time, one needs to install gnome-python-desktop to obtain this package (it might be known under different names, eg on debian python-gnome2-desktop).* '''Spell checking''': Installing python-gnome2-extras provides the gtkspell module, which adds spell checking in the notes* '''Graphviz''', '''Inkscape''': Gramps can make nice Genealogical trees (relationship graphs). These are generated by the Graphviz package, which defines a code (dot), as well as programs to produce graphs (dotty, to be called from command line). This gives you as researcher most power over how your tree will look, but has a learning curve. An alternative is to make a graphical report, converting the tree to an svg file, which you then can open/edit/refine in eg Inkscape.* '''ttf-freefont''': Useful as a font that supports a large subset of the unicode and is a true type. This works well with both gnomeprint and graphviz outputAlternative independent MS Windows version [[#3|[3]]].
Other packages might Gramps 4.0.3, see [[Gramps_4.0_Wiki_Manual_-_What's_new%3F|what's new]], is also be usefullavailable. Download [http://sourceforge.net/projects/gramps/files/Stable/4.0.3/ here].
* '''Yelp''': Gnome help browser. This allows to call and read the GRAMPS documentation on your computer.== Mac OS X ==
=Installing from source===General Requirements==[[Image:macos_200x200.png|128px|left]]
GRAMPS 2Before download: Use your '''old version of Gramps''' to [[How_to_make_a_backup#GRAMPS_version_3.0 requires python 23_and_later|backup]] your Family Trees [[#1|[1]]].3 and Read the gnome-python and pygtk2 packages. The gnome-python module should be 2.6.0 or greater. The pygtk [[Mac OS X:Application package should be version 2.5.0 or greater|before installation]] instructions.
==Downloading the source==Mac OS X 10.5, 10.6, 10.7, 10.8, and 10.9 <big><u>[http://sourceforge.net/projects/gramps/files/Stable/{{version_Mac}}/{{filename_mac_intel}}.dmg Intel {{version_Mac}}]</u></big> Mac OS X 10.5 <big><u>[http://sourceforge.net/projects/gramps/files/Stable/4.0.1/{{filename_mac_ppc}}.dmg Power PC 4.0.1]</u></big>
# The lastest stable version of GRAMPS can be downloaded from After download: Double-click the GRAMPS SourceForge page. As of writing this is gramps-2.2.6.tar.gz. Extract this dmg file in a directoryto mount the disk (note: tar xzvf gramps-zzz.tar.gz, and go into your browser may do this directory: cd grampsfor you automatically).# If you are interested in testing out Next drag the latest development version of GRAMPS, it can be obtained from SVN, see the wiki entry. The SVN version of GRAMPS is potentially very dangerous as it has not been extensively tested. It may be prone Gramps application to crashing your application folder and cause extensive data loss. Please use with cautiondouble-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.
Please, now is the time to read the INSTALL and README files accompanying the code. They come with the most recent information.{{-}}
==Installing from source code on LinuxBSD ==
GRAMPS provides a script that can be used to prepare the code for building. This script automatically calls the standard configure script.
Before upgrading your distribution: Use your '''old version of Gramps''' to [[How_to_make_a_backup#GRAMPS_version_3./autogen3_and_later|backup]] your Family Trees [[#1|[1]]].sh
This script will report any missing dependencies. Install these <big><u>[[Download#Linux and BSD distributions|via Distributions]]</u> <u>[[Download#Linux:_Install_latest_version|Latest version (see also INSTALL fileadvanced users only). Building from source code typically requires that the development versions of the required libraries be installed. You might consider setting a prefix path with autogen.sh, see the INSTALL file for instructions. Standard install is in]]</u></big>{{-}}
Once a successful run of autogen.sh has been completed, you can run the typical make procedure.== Live CD ==
make[[Image:Download_link.png|150px|left|link=http://sourceforge.net/projects/gramps/files/OldFiles/3.2.5/lgenealogy-6.1-desktop-i386.iso]]make '''Linux live CD Demonstration''' [[Linux_Genealogy_CD#Obtaining_the_CD|Obtaining the CD]] (727 MB) [[Linux Genealogy CD|Linux Genealogy CD based on Ubuntu 10.10 (Maverick Meerkat)]]. Allows you to trial a pre-installed Gramps {{Version Linux Live CD}}, 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..). If you are interested in Gramps, but are afraid to actually installit 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 [http://www.ubuntulinux.org/ Ubuntu 10.10] and Gramps from the CD anytime you like.{{-}}[[Image:Download_link.png|150px|left|link=http://cdimage.ubuntu.com/edubuntu/releases/13.04/release/]]'''Edubuntu 13.04''' includes Gramps 3.4.0{{-}}
==Installing from source code on <span id="Linux distributions"></span>Linux and BSDdistributions ==
Installing on BSD is as straithforward as on Most linuxdistributions come bundled with a version of Gramps, apart from some minor issues like tools having different namesthough it's not always the most recent version and it may not have been installed by default. See Still it is recommended to use the dedicated wiki pageGramps version that comes with your distribution.
==Installing from source code Below are ways to install Gramps on Mac OS X==some of the more popular distributions:
Some users have successfully installed GRAMPS on Mac OS X{| border="1" cellspacing="0"|Distribution|GUI pkg manager|Current versions|Notes|-|'''Linux Mint'''|Software Manager|Nadia: Gramps 3. 4.0-1<br>Lisa: Gramps 3.3.1-1<br>Isadora: Gramps 3.2.0-1 ||-|''' Mageia '''||||-|[[Image:Ubuntu_32x32.png]]''' Ubuntu '''| Software Centre|Quantal: Gramps 3.4.0-1|[http://packages.ubuntu.com/search?keywords=gramps&searchon=names available versions]|-|[[Image:Fedora_32x32.png]]''' Fedora ''' |Add/Remove Software (Gnome) or <br>Software Management (KDE)|Fedora Rawhide: Gramps 3.4.3<br>Fedora 18: Gramps 3.4.2.||-|[[Image:Debianopenlogo-32.png]]''' [[Debian]] '''|Add/Remove Software|squeeze (old stable): Gramps 3.2.3<br>wheezy (stable): Gramps 3.4.0<br>jessie (testing): Gramps 3.4.0<br>[http://packages.debian.org/sid/gramps sid (unstable)]: Gramps 3.4.0|[http://packages.debian.org/search?keywords=gramps available versions]|-|[[Image:Mandriva_32x32.png]]''' Mandriva '''|Software Management in the <br>Mandriva Linux Control Center||Mandriva 2010.1: Gramps 3.3.1<br>Mandriva 2011: Gramps 3.2.6<br>See the dedicated also [http://wiki page. Please, add to the wiki if you successfully installed GRAMPS on OS Xmandriva.com/en/Docs/Basic_tasks/Installing_and_removing_software#Advanced_use:_Backports_and_candidate_updates backports] and contrib repository|-|[[Image:Redhat_32x32.png]]''' Redhat '''||||-|''' openSUSE ''' |YaST ??|openSUSE 12.3: Gramps 3.4.2|[http://software.opensuse.org/package/gramps available versions]|-|'''Slackware'''||Slackware 14.0: Gramps 3.4.2|[http://pkgs.org/search/?keyword=gramps available versions]|-|'''NetBSD'''||NetBSD: Gramps 3.4.3|[http://pkgsrc.se/databases/gramps3 available versions]|-|'''FreeBSD'''||FreeBSD: Gramps 3.3.0|[http://portsmon.freebsd.org/portoverview.py?category=science&portname=gramps available versions]|-|'''PC-BSD'''||PC-BSD: Gramps 3.3.0||}
==Installing from source code on Windows=={{-}}
Due to the dependencies, it is difficult to install GRAMPS on Windows. Fortunately some users have made an installer hiding all these details. See the Windows page. Use this at your own risk! The developers of GRAMPS provide the space for this install page, but are not responsible for it!== Linux: Install latest version ==
==Installing from source code in Solaris==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.
Previous versions {{man warn|1=Warning|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 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.}} [[Image:Debianopenlogo-32.png]]'''[[Debian]]''' and [[Image:Ubuntu_32x32.png]]''' Ubuntu ''' [http://sourceforge.net/projects/gramps/files/Stable/{{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 gramps_{{version}}-1_all.deb For other distributions, [[Image:Download_link.png|150px|link=http://sourceforge.net/projects/gramps/files/Stable/{{version}}/gramps-{{version}}.tar.gz]] 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 [<span id="2">2</span>]Alternatively, you can click and hold on Solaristhe disk icon at the top of the window of the mounted disk, and then option-drag to the Applications folder. No recent cases are know This will create a new folder containing all the files, including the README and NEWS. [<span id="3">3</span>]An alternative independent version is [http://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ GrampsPortable_{{version_windows_portable}}.paf.exe] (20.3 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 us howeverrun Gramps type C:\PortableApps\GrampsPortable\GrampsPortable. Should exe (Or the path you have successfully installed GRAMPS it to) or make a shortcut to that file on solaris, please update your desktop or start-menu.'' By Bart.S - '''[http://portableapps.com/blog/84601 Please report issues to the wikiauthor.]''' (2012-09-07) [[Category:Documentation]]
