Introduction to GnuCash

GnuCash is a personal finance manager.

Package Information

Additional Downloads

GnuCash Dependencies


Guile-1.8.2, SLIB-3a4, GOffice-0.6.1, and GtkHTML-3.14.3


PostgreSQL-8.2.4, Guile-www, and Electric Fence

Optional (Required for the Help System)

ScrollKeeper-0.3.14 and Yelp-2.18.1 (run-time requirement to view the Help documents)

Optional (for On-Line Banking)

LibOFX (requires OpenSP-1.5.2 and cURL-7.16.3), KtoBlzCheck, and AqBanking (requires Gwenhywfar and libchipcard3)

User Notes:

Installation of GnuCash

Install GnuCash by running the following commands:

sed -i 's|xml::${sysconfdir}|xml::/etc/gnome/2.18.3|' configure &&

./configure \
    --prefix=/usr \
    --sysconfdir=/etc \
    --libexecdir=/usr/lib \
    --with-gconf-schema-file-dir=/etc/gnome/2.18.3/gconf/schemas &&

If you wish to create the API documentation in HTML format, you must have Doxygen-1.5.2 and Graphviz-2.12 installed, then issue: make doc. If you wish to create the API Design Guide in several formats, you must have teTeX-3.0 installed and issue: make -C src/doc/design html pdf ps.

To test the results, issue make check. All tests should pass. An easy way to look at the results of the tests is to issue grep -A1 ============== check.log (this is assuming you redirected the output from the tests to the indicated filename).

Now, as the root user:

make install &&

mv -v /usr/share/gnucash/doc /usr/share/doc/gnucash-2.2.4 &&
ln -v -s ../doc/gnucash-2.2.4 /usr/share/gnucash/doc &&

for FILENAME in doc/{misc*,gnome*,generic*,build*}.txt \
                doc/{gtkrc*,TRANSLATION_HOWTO,README.translator.txt} \
    install -v -m644 ${FILENAME} /usr/share/doc/gnucash-2.2.4
done &&

install -v -m755 -d /usr/share/doc/gnucash-2.2.4/api/engine &&
install -v -m644    src/doc/{TODO*,*.txt,*.html} \
                    /usr/share/doc/gnucash-2.2.4/api &&
install -v -m644    src/engine/*.txt \

If you built the API HTML or Design Guide documentation, issue the following commands (modified as necessary, depending on what docs are being installed) as the root user:

install -v -m755 -d /usr/share/doc/gnucash-2.2.4/{design,api}/html &&
install -v -m644    src/doc/design/gnucash-design.html/* \
                    /usr/share/doc/gnucash-2.2.4/design/html &&
install -v -m644    src/doc/design/gnucash-design.{pdf,ps,dvi} \
                    /usr/share/doc/gnucash-2.2.4/design &&
install -v -m644    src/doc/html/* \

If you want to install the Help documentation system, you must have ScrollKeeper-0.3.14 installed. Then unpack the additional tarball, change into the gnucash-docs-2.2.0 source directory and issue the following commands as an unprivileged user:

./configure --prefix=/usr \
            --localstatedir=/var/lib &&

HTML versions of the Help Manual and Users Guide can be created if the DocBook XML tools are installed (libxslt-1.1.22, DocBook XML DTD-4.5 and DocBook XSL Stylesheets-1.71.1). A PDF version of the Users Guide can be created if you have DocBook-utils-0.6.14 and JadeTeX-3.13 installed. Issue the following commands to create the documentation (modify as appropriate for your desires):

make -C help  html &&
make -C guide html &&
make -C guide pdf

Now, as the root user:

make install

If you built the Help Manual or Users Guide, install them using the following commands as the root user (modify as necessary):

install -v -m755 -d /usr/share/doc/gnucash-2.2.0/{users_guide,help} &&
cp -v -R            help/C/gnucash-help/* \
                    /usr/share/doc/gnucash-2.2.0/help &&
cp -v -R            guide/C/gnucash-guide/* \
                    /usr/share/doc/gnucash-2.2.0/users_guide &&
install -v -m644    guide/C/gnucash-guide.pdf \

Note that you must have Yelp-2.18.1 installed in order to view the Help documents using the default GnuCash method.

Command Explanations

sed -i 's|xml::${sysconfdir}|xml::/etc/gnome/2.18.3|' configure: This command is used because the location of the GConf source database is hard-coded into the configure script as $sysconfdir/gconf (rendering the --with-gconf-source parameter useless). The modification ensures that the GConf database is properly updated while still allowing the package configuration files to be installed in /etc/gnucash.

--sysconfdir=/etc: This installs configuration files in /etc/gnucash instead of /usr/etc/gnucash.

--with-gconf-schema-file-dir=/etc/gnome/2.18.3/gconf/schemas: This parameter ensures that the GConf schema files are installed in the proper location instead of /etc/gconf.

mv -v /usr/share/gnucash/doc /usr/share/doc/gnucash-2.2.4 and ln -v -s ../doc/gnucash-2.2.4 /usr/share/gnucash/doc: These commands are used to relocate the documentation files to the customary location and create a symbolic link to the original location.

--localstatedir=/var/lib: This parameter is used so that all ScrollKeeper files are installed in, and the ScrollKeeper database is properly updated in /var/lib/scrollkeeper instead of some files being installed in $GNOME_PREFIX/var/scrollkeeper.

--enable-sql: This parameter is required if you want to build in SQL support using PostgreSQL.

--enable-hbci: This parameter is required if you want to build in on-line banking support using AqBanking. See doc/README.HBCI in the GnuCash source tree for complete information.

Configuring GnuCash

Configuration Information

If you wish to use GnuCash to retrieve stock price quotes, you'll need to install the following Perl modules: libwww-perl-5.806, Date::Manip-5.54, HTML::Parser-3.56, HTML::TableExtract-2.10, Crypt::SSLeay-0.56, and Finance::Quote-1.13. Alternatively, you can run the /usr/bin/gnc-fq-update script as the root user.


Installed Programs: gnc-fq-check, gnc-fq-dump, gnc-fq-helper, gnc-fq-update, gnc-test-env, gnucash, gnucash-bin, gnucash-env, gnucash-make-guids, gnucash-valgrind, and update-gnucash-gconf
Installed Libraries:,,,,,, and numerous support libraries installed in /usr/lib/gnucash
Installed Directories: /etc/gnucash, /usr/include/gnucash, /usr/lib/gnucash, and the following subdirectories of /usr/share/: doc/gnucash-2.2.4, gnome/help/gnucash, gnucash, omf/gnucash-docs, and /xml/gnucash

Short Descriptions


is a personal finance manager.

Last updated on 2008-04-15 03:34:07 -0500