Difference between revisions of "Installation"

From Gramps
Jump to: navigation, search
(Redirecting to Download)
 
Line 1: Line 1:
#redirect [[Download]]
+
[[Category:Documentation]]
 +
 
 +
==Easy download and install of GRAMPS 2.2.6==
 +
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 [[Linux Genealogy CD]]. It runs without installing on the hard disk and contains a collection of open source, free, genealogy programs. You can install [http://ubuntu.com Ubuntu 6.06 LTS] and GRAMPS from the CD anytime you like.
 +
 
 +
==Upgrading to latest version==
 +
If your version of GRAMPS is not current, some users offer up to date packages for some distributions:
 +
 
 +
* '''Ubuntu''': On sourceforge, [http://sourceforge.net/project/showfiles.php?group_id=25770 download] 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=22f80a050a1e3cffffd590db0813dea9&showtopic=28727&pid=152093&st=0&#entry152093. this forum entry].
 +
* '''Mandriva''': Packages for Mandriva are available for use with urpmi from [http://seerofsouls.com/ SeerOfSouls.com].
 +
* '''Fedora''': The alternative to installing from source (described below) 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 release).
 +
 
 +
''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.''
 +
 
 +
In all other cases, you must [http://sourceforge.net/project/showfiles.php?group_id=25770 download] the source package zzz.tar.gz, and install GRAMPS manually. See below for details.
 +
 
 +
==Windows, BSD, MacOs, Solaris==
 +
For Windows, there is an experimental [[Windows installer]]. 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.
 +
 
 +
==Gnome and KDE==
 +
You can use both, but GRAMPS fits in better with GNOME. For KDE there are some minor issues due to some (GTK) issues outside of GRAMPS. Check the [[KDE page]] to know what these problems might be.
 +
 
 +
=Additional software GRAMPS can benefit from=
 +
GRAMPS does not rely on the following programs, however, having them will increase your productivity:
 +
 
 +
* '''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 output.
 +
 
 +
Other packages might also be usefull:
 +
 
 +
* '''Yelp''': Gnome help browser. This allows to call and read the GRAMPS documentation on your computer.
 +
 
 +
=Installing from source=
 +
==General Requirements==
 +
 
 +
GRAMPS 2.0 requires python 2.3 and the gnome-python and pygtk2 packages. The gnome-python module should be 2.6.0 or greater. The pygtk package should be version 2.5.0 or greater.
 +
 
 +
==Obtaining the source==
 +
 
 +
* The lastest stable version of GRAMPS can be downloaded from the [http://sourceforge.net/projects/gramps GRAMPS SourceForge page]. As of this writing, this is gramps-2.2.6.tar.gz. Extract this file into a directory: <code>
 +
  tar xzvf gramps-zzz.tar.gz
 +
</code> and then go into this directory:<code>
 +
  cd gramps-zzz
 +
</code>
 +
* If you are interested in testing out the latest development version of GRAMPS, it can be obtained from SVN, see [[Brief introduction to SVN]]. The SVN version of GRAMPS is potentially very dangerous as it has not been extensively tested. It may be prone to crashing and cause extensive data loss. Please use with caution.
 +
 
 +
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 Linux==
 +
 
 +
GRAMPS provides a script that can be used to prepare the code for building. This script automatically calls the standard configure script:<code>
 +
  ./autogen.sh</code>
 +
 
 +
This script will report any missing dependencies. Install these (see also INSTALL file). 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
 +
 
 +
Once a successful run of autogen.sh has been completed, you can run the typical make procedure.<code>
 +
  make
 +
  make install</code>
 +
 
 +
==Installing from source code on BSD==
 +
 
 +
Installing on BSD is as straithforward as on linux, apart from some minor issues like tools having different names. See the [[BSD page]] for details.
 +
 
 +
==Installing from source code on Mac OS X==
 +
 
 +
Some users have successfully installed GRAMPS on Mac OS X. See the [[Mac OS X]] page for details. Please, add to the wiki if you successfully installed GRAMPS on OS X.
 +
 
 +
==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 installer]] page for details. Use this at your own risk! The developers of GRAMPS provide the space for this install page, but are not responsible for it!
 +
 
 +
==Installing from source code on Solaris==
 +
 
 +
Previous versions of GRAMPS have run on Solaris. No recent cases are know to us however. Should you have successfully installed GRAMPS on solaris, please update the [[Solaris page]].

Revision as of 01:36, 1 March 2007


Easy download and install of GRAMPS 2.2.6

Before downloading, check if the version of GRAMPS in your distribution is not current:

  • Debian, (K,X,Edu)Ubuntu, Mepis, Suse:
  apt-get install gramps
  • Fedora:
  yum install gramps

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 Linux Genealogy CD. It runs without installing on the hard disk and contains a collection of open source, free, genealogy programs. You can install Ubuntu 6.06 LTS and GRAMPS from the CD anytime you like.

Upgrading to latest version

If your version of GRAMPS is not current, some users offer up to date packages for some distributions:

  • Ubuntu: On sourceforge, download 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 his repository. See also this forum entry.
  • Mandriva: Packages for Mandriva are available for use with urpmi from SeerOfSouls.com.
  • Fedora: The alternative to installing from source (described below) 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 release).

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.

In all other cases, you must download the source package zzz.tar.gz, and install GRAMPS manually. See below for details.

Windows, BSD, MacOs, Solaris

For Windows, there is an experimental Windows installer. 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.

Gnome and KDE

You can use both, but GRAMPS fits in better with GNOME. For KDE there are some minor issues due to some (GTK) issues outside of GRAMPS. Check the KDE page to know what these problems might be.

Additional software GRAMPS can benefit from

GRAMPS does not rely on the following programs, however, having them will increase your productivity:

  • 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 output.

Other packages might also be usefull:

  • Yelp: Gnome help browser. This allows to call and read the GRAMPS documentation on your computer.

Installing from source

General Requirements

GRAMPS 2.0 requires python 2.3 and the gnome-python and pygtk2 packages. The gnome-python module should be 2.6.0 or greater. The pygtk package should be version 2.5.0 or greater.

Obtaining the source

  • The lastest stable version of GRAMPS can be downloaded from the GRAMPS SourceForge page. As of this writing, this is gramps-2.2.6.tar.gz. Extract this file into a directory:
  tar xzvf gramps-zzz.tar.gz

and then go into this directory:

  cd gramps-zzz

  • If you are interested in testing out the latest development version of GRAMPS, it can be obtained from SVN, see Brief introduction to SVN. The SVN version of GRAMPS is potentially very dangerous as it has not been extensively tested. It may be prone to crashing and cause extensive data loss. Please use with caution.

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 Linux

GRAMPS provides a script that can be used to prepare the code for building. This script automatically calls the standard configure script:

  ./autogen.sh

This script will report any missing dependencies. Install these (see also INSTALL file). 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

Once a successful run of autogen.sh has been completed, you can run the typical make procedure.

  make
  make install

Installing from source code on BSD

Installing on BSD is as straithforward as on linux, apart from some minor issues like tools having different names. See the BSD page for details.

Installing from source code on Mac OS X

Some users have successfully installed GRAMPS on Mac OS X. See the Mac OS X page for details. Please, add to the wiki if you successfully installed GRAMPS on OS X.

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 installer page for details. Use this at your own risk! The developers of GRAMPS provide the space for this install page, but are not responsible for it!

Installing from source code on Solaris

Previous versions of GRAMPS have run on Solaris. No recent cases are know to us however. Should you have successfully installed GRAMPS on solaris, please update the Solaris page.