hledger/site/download.md

Download

Release notes

I want to download a packaged version

on Windows	Download, unzip, and run hledger-0.26-win64.zip and/or hledger-web-0.26-win64.zip (The current release is 0.27. To contribute binaries for windows or mac, please get in touch.)
on Mac	Build with stack or cabal as described 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 VM	Try https://github.com/sciurus/hledger-vagrant

I want to build the latest release (0.27)

with stack (most reliable, recommended)

1. Install stack (On Windows, the 64-bit version is recommended.)
2. stack setup (if you need GHC installed. If you’re not sure, run the next command and it will tell you.)
3. stack --resolver nightly install hledger (installs just the command-line interface), or
   stack --resolver nightly install hledger-web (installs both CLI and web interface)
   2015/11/3: hledger-ui has not yet reached stackage; you must install it from source or with cabal, see below.
4. Ensure ~/.local/bin or the Windows equivalent is in your $PATH, so that you can just type hledger to run it. (stack will show the proper directory and will tell you if it is not in $PATH).

Eg, on a mac:

with cabal (results will vary, recommended only if you can’t install stack):

1. Install GHC and cabal if needed.
2. Ensure ~/.cabal/bin or the Windows equivalent is in your $PATH.
3. cabal update
4. cabal install alex happy
5. mkdir hledger-sandbox
6. cd hledger-sandbox
7. cabal sandbox init
8. cabal install hledger[-ui|-web] (On Windows, hledger-ui is not yet supported.)
9. Ensure this .../hledger-sandbox/.cabal-sandbox/bin is in your $PATH (or move its contents to ~/.cabal/bin).

I want to build the unreleased git version

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

or see the Developer Guide for more help.