Difference between revisions of "Installation"

From GnuCash
Jump to: navigation, search
(Linux: repology.org; use {{FallbackMainVersion}})
 
(21 intermediate revisions by 5 users not shown)
Line 1: Line 1:
__NOTOC__
+
[[Category:Installation]] [[Category:Operating System‏‎]]
 +
{| class="wikitable" style="margin: auto;"
 +
! scope="row"|Languages
 +
| [[de/{{PAGENAME}}|Deutsch]]
 +
| [[He/{{PAGENAME:התקנה}}|עִברִית]]
 +
|}
 
GnuCash runs under Windows, MacOS, and many flavors of Linux/Unix. Installation is generally quite easy; instructions specific to different supported operating systems are given below.  
 
GnuCash runs under Windows, MacOS, and many flavors of Linux/Unix. Installation is generally quite easy; instructions specific to different supported operating systems are given below.  
  
If you need to use a version of GnuCash more up to date than the version available from your operating system or distribution's repositories and software sources, you can build GnuCash from source code. Links to instructions for building from the sources are provided on the appropriate OS/distribution installation pages. If specific instructions are not yet available for your system, you may consider adapting available instructions from a similar OS/distribution.
+
If you need to use a version of GnuCash more up to date than the version available from your operating system or distribution's repositories and software sources, you can [[Building|build GnuCash from source code]]. Links to instructions for building from the sources are provided on the appropriate OS/distribution installation pages. If specific instructions are not yet available for your system, you may consider adapting available instructions from a similar OS/distribution.  
== Linux ==
 
You can check
 
* [https://repology.org/project/gnucash/versions repology.org] or
 
* ''distrowatch.com'' for distributions which include
 
:the [https://distrowatch.com/search.php?pkg=gnucash&relation=equal&pkgver={{Version}}&distrorange=InAny#pkgsearch recent],
 
:an [https://distrowatch.com/search.php?pkg=gnucash&relation=greaterequal&pkgver={{FallbackVersion}}&distrorange=InLatest#pkgsearch almost recent] or also
 
:[https://distrowatch.com/search.php?pkg=gnucash&relation=greater&pkgver={{FallbackMainVersion}}&distrorange=InLatest#pkgsearch older] versions of GnuCash.
 
  
Notes on specific distributions:
+
== Unix Derivates ==
* [[Debian]]
+
=== Linux ===
* [[Gentoo]]
+
Linux users usually use their distribution's software management to install GnuCash and its dependencies.
* [[Mandriva]]
 
* [[RedHat]]: FC5, RHEL4, CentOS4.3, RHEL5 / SL5.
 
* [[SuSE]]
 
* [[Slackware]]
 
* [[Ubuntu]] (and derivatives)
 
  
Distribution agnostic ''recent (stable and test) versions'' of GnuCash can now be installed, too:
+
You can check distributions for ''available'' versions of GnuCash by
 +
* [https://repology.org/project/gnucash/versions repology.org] or
 +
*''distrowatch.com''
 +
**the [https://distrowatch.com/search.php?pkg=gnucash&relation=equal&pkgver={{Version}}&distrorange=InAny#pkgsearch recent],
 +
**an [https://distrowatch.com/search.php?pkg=gnucash&relation=greaterequal&pkgver={{FallbackVersion}}&distrorange=InLatest#pkgsearch almost recent] or also
 +
**[https://distrowatch.com/search.php?pkg=gnucash&relation=greater&pkgver={{FallbackMainVersion}}&distrorange=InLatest#pkgsearch older] GnuCash version.
 +
;Tip:Depending on their update policy there can be a separate repository <tt>Backports</tt> or similar with a more recent version.
  
* [[Flatpak]]
+
;Specific [{{URL:wp}}Linux_distribution distribution] families:
 +
: [[Debian]]
 +
:: [[Ubuntu]] (and derivatives)
 +
: [[Gentoo]]
 +
: [[Mandriva]]
 +
: [[RedHat]] based: Fedora, RHEL, CentOS, …
 +
: open[[SuSE]]
 +
: [[Slackware]]
  
== Windows ==
+
;Distribution agnostic: ''recent (both stable and test) versions'' of GnuCash can now be installed, too:
Download the binary installer package from [https://sourceforge.net/projects/gnucash/files/ sourceforge.net] or [https://github.com/Gnucash/gnucash/releases Github]. There are also recent nightly builds of [{{BuildURL}}/builds/win32/maint maint] and [{{BuildURL}}/builds/win32/master master] are on [{{BuildURL}}/builds/win32 code.gnucash.org]. See [[Windows|Microsoft Windows]] for more information.
+
:* [[Flatpak]]
  
== MacOS ==
+
=== MacOS ===
Download the binary package from [https://sourceforge.net/projects/gnucash/files/gnucash%20%28stable%29/ sourceforge.net] or [https://github.com/Gnucash/gnucash/releases Github]. Once you have downloaded the disk image, double click to open it, and then drag the app icon into your Applications folder (or anywhere else on your system that you choose). If you plan to use online features, drag the "Install Online Quotes" icon as well. Once you have copied them to your system, you can close the disk image. To run Gnucash, double click the icon on your system.
+
Download the binary package from [{{URL:SF}}projects/gnucash/files/gnucash%20%28stable%29/ sourceforge.net] or [{{URL:GH}}Gnucash/gnucash/releases Github]. Once you have downloaded the disk image, double click to open it, and then drag the app icon into your Applications folder (or anywhere else on your system that you choose). If you plan to use online features, drag the "Install Online Quotes" icon as well. Once you have copied them to your system, you can close the disk image. To run Gnucash, double click the icon on your system.
 
* For compiling GnuCash on MacOS, see [[MacOS Installation]] and specific [[MacOS/Quartz]] tips
 
* For compiling GnuCash on MacOS, see [[MacOS Installation]] and specific [[MacOS/Quartz]] tips
  
= Other Operating Systems =
+
=== Others ===
 
* [[FreeBSD]]
 
* [[FreeBSD]]
 
* [[Solaris]]
 
* [[Solaris]]
 +
 +
== Other Operating Systems ==
 +
=== Windows ===
 +
Download the binary installer package from [{{URL:SF}}projects/gnucash/files/gnucash%20%28stable%29/ sourceforge.net] or [{{URL:GH}}Gnucash/gnucash/releases Github]. There are also recent nightly builds of [{{URL:Build:Win}} stable] and—after creation—[{{URL:Build:Win|future}} future] are on [{{BuildURL}}/builds/win32 {{BuildServer}}]. See [[Windows|Microsoft Windows]] for more information.
 +
 +
== Upgrading ==
 +
When upgrading GnuCash, there is no need to uninstall previous versions. It is a good practice to make a [[backup]] of your '''data''' and '''settings''' prior to any upgrade in case anything goes wrong with the upgrade.
 +
 +
Minor upgrades (within, for example, version {{MainVersion}}.xx below {{BetaSeries}}) will not include changes to the data file structures, meaning that it is easy to return to the earlier minor version simply by reinstalling the earlier version.
 +
 +
Major upgrades ''may'' include feature or structural changes in data storage that make reversion to an earlier version impossible, and returning to the earlier software version requires you also to use an earlier data file--another reason to make a backup before upgrading!
 +
 +
If you are upgrading from a much older version, the recommended method is to:
 +
# Make a backup of your data file.
 +
# Upgrade to the ''last'' release in ''each major'' version.
 +
# Open the data file in that version and perform a <tt>check & repair</tt><ref>
 +
;check & repair: There are a bunch of routines that we call '''scrubs''' that run at the beginning of a session. They
 +
:;uncorrupt data: from a few bugs known to have caused problems, do some
 +
:;data-integrity checks: like
 +
:::making sure that transactions balance: and that
 +
:::all of the accounts referenced in splits actually exist,
 +
::and make
 +
:;data changes for older files: needed by the current GnuCash version.
 +
:Check and repair runs those scrubs (again) plus a few more.</ref> on the entire file.
 +
Here are the last release of each major version:
 +
:;Version 4: 4.14
 +
:;Version 3: 3.11
 +
:;Version 2: 2.6.21
 +
 +
== See also ==
 +
* [[Configuration Locations]]

Latest revision as of 21:28, 19 January 2024

Languages Deutsch עִברִית

GnuCash runs under Windows, MacOS, and many flavors of Linux/Unix. Installation is generally quite easy; instructions specific to different supported operating systems are given below.

If you need to use a version of GnuCash more up to date than the version available from your operating system or distribution's repositories and software sources, you can build GnuCash from source code. Links to instructions for building from the sources are provided on the appropriate OS/distribution installation pages. If specific instructions are not yet available for your system, you may consider adapting available instructions from a similar OS/distribution.

Unix Derivates

Linux

Linux users usually use their distribution's software management to install GnuCash and its dependencies.

You can check distributions for available versions of GnuCash by

Tip
Depending on their update policy there can be a separate repository Backports or similar with a more recent version.
Specific distribution families
Debian
Ubuntu (and derivatives)
Gentoo
Mandriva
RedHat based: Fedora, RHEL, CentOS, …
openSuSE
Slackware
Distribution agnostic
recent (both stable and test) versions of GnuCash can now be installed, too:

MacOS

Download the binary package from sourceforge.net or Github. Once you have downloaded the disk image, double click to open it, and then drag the app icon into your Applications folder (or anywhere else on your system that you choose). If you plan to use online features, drag the "Install Online Quotes" icon as well. Once you have copied them to your system, you can close the disk image. To run Gnucash, double click the icon on your system.

Others

Other Operating Systems

Windows

Download the binary installer package from sourceforge.net or Github. There are also recent nightly builds of stable and—after creation—future are on code.gnucash.org. See Microsoft Windows for more information.

Upgrading

When upgrading GnuCash, there is no need to uninstall previous versions. It is a good practice to make a backup of your data and settings prior to any upgrade in case anything goes wrong with the upgrade.

Minor upgrades (within, for example, version 5.xx below 5.9xx) will not include changes to the data file structures, meaning that it is easy to return to the earlier minor version simply by reinstalling the earlier version.

Major upgrades may include feature or structural changes in data storage that make reversion to an earlier version impossible, and returning to the earlier software version requires you also to use an earlier data file--another reason to make a backup before upgrading!

If you are upgrading from a much older version, the recommended method is to:

  1. Make a backup of your data file.
  2. Upgrade to the last release in each major version.
  3. Open the data file in that version and perform a check & repair[1] on the entire file.

Here are the last release of each major version:

Version 4
4.14
Version 3
3.11
Version 2
2.6.21

See also

  • check & repair
    There are a bunch of routines that we call scrubs that run at the beginning of a session. They
    uncorrupt data
    from a few bugs known to have caused problems, do some
    data-integrity checks
    like
    making sure that transactions balance: and that
    all of the accounts referenced in splits actually exist,
    and make
    data changes for older files
    needed by the current GnuCash version.
    Check and repair runs those scrubs (again) plus a few more.
  • Retrieved from "https://code.gnucash.org/wiki/index.php?title=Installation&oldid=21990"