hledger/site/download.md

 

Download

A. I want to download a packaged version

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.
Mac	brew install hledger hledger-ui/hledger-web have not yet been added to homebrew.
Debian, Ubuntu	sudo apt install hledger hledger-ui hledger-web
Fedora, RHEL	sudo dnf install hledger hledger-ui/hledger-web have not yet been added to Fedora.
Gentoo	sudo layman -a haskell && sudo emerge hledger hledger-ui hledger-web
NixOS	nix-env -iA nixpkgs.haskellPackages.hledger \   nixpkgs.haskellPackages.hledger-ui \   nixpkgs.haskellPackages.hledger-web

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

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

Debian, Ubuntu	sudo apt install ... ?
Fedora, RHEL	sudo dnf install ncurses-devel

C. I want to build the latest development version

This includes the latest features and is normally stable enough for daily use (it’s what I use).

1. Install stack and GHC (steps 1 and 2 above) and git
2. git clone http://code.hledger.org hledger
3. cd hledger
4. stack install [hledger] [hledger-ui] [hledger-web] [hledger-api]

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