hledger/site/download.md

 

Download

I want to download a packaged version

on Windows	Download and run hledger-0.26-win64.exe & hledger-web-0.26-win64.exe (old), or the latest development builds. hledger-ui does not run on Windows.
on Mac	brew install hledger
on Debian or Ubuntu	sudo apt 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 to make building easier. On Windows, the 64-bit version is recommended.

2. stack setup
   to ensure you have a suitable 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 commands like 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 (please send updates):

on Debian or Ubuntu	sudo apt install ...
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.