Difference between revisions of "MacOS Installation"

From GnuCash
Jump to: navigation, search
(Update compatibility information, remove Fink, add Homebrew.)
Line 1: Line 1:
 
== Download, Drag, and Drop ==
 
== Download, Drag, and Drop ==
Download the current release (either Intel or PowerPC, depending on your architecture) from the [http://www.gnucash.org/download.phtml download page].
+
Download the current release from the [http://www.gnucash.org/download.phtml download page]. Note that GnuCash 3 and later are supported only on MacOS 10.9 (Mavericks) and later; users of MacOS X 10.5 (Leopard) - 10.7 (Lion), including those with PowerPC Macs, should be sure to download GnuCash 2.6.21, paying attention to the supported architecture.
  
 
Open the disk image and drag GnuCash from there to your applications folder. If you want to retrieve stock prices from the web, double-click on ''Finance Quote Update''. '''This will run a terminal application, even opening Terminal for you. It's a bit of a pain and requires that you have XCode installed. We're sorry about that, but we haven't been able to figure out a better way.'''
 
Open the disk image and drag GnuCash from there to your applications folder. If you want to retrieve stock prices from the web, double-click on ''Finance Quote Update''. '''This will run a terminal application, even opening Terminal for you. It's a bit of a pain and requires that you have XCode installed. We're sorry about that, but we haven't been able to figure out a better way.'''
  
 
''Upgrades:'' Same procedure: Download, drag, and drop. If, ''and only if'' you're upgrading from a version before 2.4.0, double click on ''Upgrade Dirs'' in the disk-image.
 
''Upgrades:'' Same procedure: Download, drag, and drop. If, ''and only if'' you're upgrading from a version before 2.4.0, double click on ''Upgrade Dirs'' in the disk-image.
 
''Readme:'' Be sure to read the '''Readme''' in the disk image. It has extra information about that particular release of Gnucash.
 
 
''SQL Backends:'' The only SQL driver included with the downloadable version is for SQLite3, which creates a local file. If you really need to use a MySQL or Postgresql server you'll have to build the drivers yourself. Instructions may be found in [[MacOS/Quartz#Building_Libdbi_Drivers |Quartz Build page]]. ('''Remember that Gnucash is ''single-user'' even when connected to a database server. That means only ''one user'' can be connected to a database at a time.''')
 
  
 
== Building yourself ==
 
== Building yourself ==
 
Instructions for building a complete Gnucash application, including bundling it for distribution, are at [[MacOS/Quartz]].
 
Instructions for building a complete Gnucash application, including bundling it for distribution, are at [[MacOS/Quartz]].
  
== Other Ways ==
 
There are other ways to get Gnucash on your Mac. These instructions may be old, but the procedures haven't changed much.
 
 
=== Using Fink ===
 
 
[http://fink.sourceforge.net/ Fink] is a package-management tool making it easier to install all your favorite *nix tools and libraries under macOS.  It's also the quickest and easiest way to get at least some version of GnuCash running on a PowerPC Mac (Intel Mac users see [[#Intel_Macs|below]].)
 
 
====Installing Fink====
 
  
Follow instructions to [http://www.finkproject.org/download/srcdist.php install fink from source]. You will need to install Apple's Xcode Tools before you can install anything from source (aka: compiling). Be sure you have already installed Apple's Xcode Tools (it is on your Leopard DVD) before trying to install fink from source.
+
=== MacPorts ===
  
==== Other Fink options ====
+
MacPorts is a parallel package manager to make MacOS work like Linux. See [[MacOS/MacPortsDetail]] for more information.
Further discussion of semi-manual ways to compile GnuCash using Fink tools can be found [[MacOSX/FinkManual|here]]. Most of that information is generally outdated since the availability of the gnucash2 package.  However, it may still be useful in some cases, for example if you would like to use Fink in conjunction with compiling a version of GnuCash newer than any available in a Fink package.
 
  
=== Using MacPorts ===
+
=== HomeBrew ===
  
MacPorts (formerly known as DarwinPorts) is another, parallel package manager for macOS. See [[MacOS/MacPortsDetail]] for more information.
+
A newer and more popular package manager for making MacOS work like Linux, [https://brew.sh/ HomeBrew] just redistributes the GnuCash application bundle. You might as well get it from here.
  
 
== Final Words ==
 
== Final Words ==

Revision as of 23:24, 27 June 2019

Download, Drag, and Drop

Download the current release from the download page. Note that GnuCash 3 and later are supported only on MacOS 10.9 (Mavericks) and later; users of MacOS X 10.5 (Leopard) - 10.7 (Lion), including those with PowerPC Macs, should be sure to download GnuCash 2.6.21, paying attention to the supported architecture.

Open the disk image and drag GnuCash from there to your applications folder. If you want to retrieve stock prices from the web, double-click on Finance Quote Update. This will run a terminal application, even opening Terminal for you. It's a bit of a pain and requires that you have XCode installed. We're sorry about that, but we haven't been able to figure out a better way.

Upgrades: Same procedure: Download, drag, and drop. If, and only if you're upgrading from a version before 2.4.0, double click on Upgrade Dirs in the disk-image.

Building yourself

Instructions for building a complete Gnucash application, including bundling it for distribution, are at MacOS/Quartz.


MacPorts

MacPorts is a parallel package manager to make MacOS work like Linux. See MacOS/MacPortsDetail for more information.

HomeBrew

A newer and more popular package manager for making MacOS work like Linux, HomeBrew just redistributes the GnuCash application bundle. You might as well get it from here.

Final Words

If you encounter problems, please check the mailing list archives first and then, if your problem cannot be resolved based on the information found there, report it to the mailing list. Please do remember that GnuCash developers are volunteers and are not responsible for your computer; as such, your help (in the form of exhausting readily available resources before asking for help and in asking for help in a clear manner) is appreciated.