hledger/site/download.md
2016-04-12 20:32:14 -07:00

4.4 KiB

 
# Download

I want to download a packaged version

**on Windows** Download and run [hledger-0.26-win64.exe](http://hledger.org/downloads/hledger-0.26-win64.exe) and/or [hledger-web-0.26-win64.exe](http://hledger.org/downloads/hledger-web-0.26-win64.exe) (The current release is 0.27. To contribute binaries for windows or mac, please get in touch.)
**on Mac** `brew install hledger`
**on Debian or Ubuntu** `apt-get install hledger hledger-web`
**on Gentoo** `layman -a haskell && emerge hledger hledger-web`
**on Fedora** `yum install hledger`
**on NixOS** `nix-env -iA nixpkgs.haskellPackages.hledger nixpkgs.haskellPackages.hledger-web`

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 install hledger [hledger-ui] [hledger-web]
  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).

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).

in a VM

  • if stack or cabal can't run on your OS, maybe this vagrant image can ?

Here are the release notes.

I want to build the unreleased git version

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

See also the Developer Guide.