hledger/doc/site/download.md
2015-08-24 09:34:26 -07:00

4.0 KiB

Download

paypal Flattr this
## I want to download and run
**on Windows** Download, unzip, and run [hledger-0.26-win64.zip](http://hledger.org/downloads/hledger-0.26-win64.zip) and/or [hledger-web-0.26-win64.zip](http://hledger.org/downloads/hledger-web-0.26-win64.zip)
**on Mac** Use stack or cabal (see below)
**on Debian or Ubuntu** `apt-get install hledger hledger-web`
**on Gentoo** `emerge hledger hledger-web`
**on Fedora** `yum install hledger`
**on NixOS** `nix-env -iA nixpkgs.haskellPackages.hledger nixpkgs.haskellPackages.hledgerWeb`
**in a Virtualbox VM** Try

Release notes

I want to build the latest release

Using the stack tool (easiest, recommended):

  1. Install stack (on Windows, you should choose the 64-bit stack download if you will be processing >50,000 transactions at a time with hledger, cf #275).

  2. stack setup (if you need GHC installed. If you're not sure, run the next command and it will tell you.)

  3. stack install hledger (the command-line UI), or
    stack install hledger-ui (the terminal UI; not available on Windows; includes the above), or
    stack install hledger-web (the web UI; includes the above)

  4. stack will report where it installed the binaries (~/.local/bin or the Windows equivalent). You should ensure this directory is in your $PATH (stack will let you know), so that you can just type hledger to run it.

Without stack, the process is much more variable; this is most likely to work:

  1. Install GHC and cabal if needed
  2. cabal update
  3. cabal install alex happy
  4. cabal sandbox init
  5. cabal install hledger[-ui|-web]
  6. Ensure ~/.cabal/bin or the Windows equivalent is in your $PATH

I want to build the latest master branch

See the Developer Guide, or just:

  1. git clone http://code.hledger.org hledger
  2. cd hledger
  3. stack install