hledger/site/download.md

 

Download

I want to download a packaged version

on Windows	hledger-0.26-win64.exe and/or hledger-web-0.26-win64.exe (not the latest release. You can get the latest development builds from Appveyor CI here. Note hledger-ui is not supported on Windows.)
on Mac	brew install hledger
on Debian or Ubuntu	sudo apt-get install hledger hledger-web
on Fedora or RHEL	sudo dnf install hledger
on Gentoo	sudo (layman -a haskell && emerge hledger hledger-web)
on NixOS	nix-env -iA nixpkgs.haskellPackages.hledger nixpkgs.haskellPackages.hledger-web

I want to build the latest released version

The latest release may be newer than your OS’s packaged version. (Here are the latest release notes.)

1. Install stack. On Windows, the 64-bit version is recommended.

2. stack setup to ensure you have the required version of GHC.

3. stack install hledger [hledger-ui] [hledger-web]
   hledger-ui and hledger-web take longer to build. hledger-ui is not buildable on Windows.

4. If stack warns that ~/.local/bin or the Windows equivalent is not in your $PATH, configure that, so that the command hledger will work. Eg if you’re a bash user:
   echo "export PATH=$PATH:~/.local/bin" >> ~/.bashrc && source ~/.bashrc

Or use cabal if you prefer and know how. It’s harder to use and to support, so these docs focus on stack.

Note: Haskell builds can fail due to missing C libraries or headers, which stack/cabal can not install. If you have this problem, here are some C libs you might need (updates welcome):

on Debian or Ubuntu
on Fedora or RHEL	sudo dnf install ncurses-devel

I want to build the latest development version

This includes the latest features and is normally stable enough for daily use; recommended.

1. git clone http://code.hledger.org hledger
2. cd hledger
3. stack install [hledger] [hledger-ui] [hledger-web] [hledger-api]

cabal users, try ./cabal-install.sh instead.