slaesvuo/hledger
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
f548abf71c
hledger/site/download.md
Simon Michael 02bdbd8877 site: download updates 
[ci skip]
2016-09-14 17:20:07 -07:00

5.5 KiB
Raw Blame History

 

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.