hledger/site/download.md
Simon Michael 671ade5062 site: simplify, clean up, refresh
- Docs are now collected on a single page
- Lots of copy updates
- The front page is less cluttered
- More whitespace at the sides
- The (still WIP) man pages are now linked
- Describe and link to plaintextaccounting.org
2016-02-21 12:39:32 -08:00

4.4 KiB

 
# 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** `brew install hledger`
**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.hledger-web`

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 install hledger [hledger-ui] [hledger-web]
  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).

in a VM

  • if stack or cabal can't run on your OS, maybe this vagrant image can ?

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.