hledger/site/download.md
2015-11-07 11:22:57 -08:00

4.6 KiB

paypal Flattr this
# Download

Release notes

I want to download a packaged version

**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)
(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

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

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.