2015-07-23 01:19:41 +03:00
< div style = "float:right; text-align:right; white-space:nowrap; " >
2016-02-21 23:39:32 +03:00
< a style = "margin-left:3px;" href = "https://flattr.com/submit/auto?user_id=simonmichael&url=http%3A%2F%2Fhledger.org" target = "_blank" > < img src = "//api.flattr.com/button/flattr-badge-large.png" alt = "" title = "Flattr this" border = "0" > < / a >
< a href = "https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=5J33NLXYXCYAY" > < img width = 62 height = 31 border = 0 src = "https://www.paypal.com/en_US/i/btn/x-click-but04.gif" alt = "" > < / a >
< div style = "display:inline-block; position:relative; top:5px; width:62px; height:31px;" >
2015-07-23 01:19:41 +03:00
< script data-gratipay-username = "simonmichael" data-gratipay-widget = "button" src = "//grtp.co/v1.js" > < / script >
< / div >
2016-02-21 23:39:32 +03:00
< a href = "https://www.bountysource.com/trackers/536505-simonmichael-hledger" > < img border = 0 src = "https://www.bountysource.com/badge/tracker?tracker_id=536505" alt = "" > < / a >
2015-07-29 03:30:17 +03:00
< / div >
2015-11-04 05:59:12 +03:00
# Download
2015-11-10 01:10:59 +03:00
< a name = "packaged" > < / a >
2015-11-07 22:22:57 +03:00
## I want to download a packaged version
2014-11-05 08:18:13 +03:00
<!-- <sub>(If the download is out of date or doesn't run on my system, I might troubleshoot or donate to fund improvements)</sub> -->
2015-07-23 17:05:28 +03:00
< style >
tr { vertical-align:top; }
2016-02-21 23:39:32 +03:00
td { padding-bottom:.5em; padding-right:1em; }
2016-09-13 22:08:37 +03:00
td:first-of-type {
/* white-space:nowrap; */
/* width:1%; */
}
a { white-space:nowrap; }
2015-07-23 17:05:28 +03:00
< / style >
2016-09-13 21:38:56 +03:00
|
2016-09-13 22:08:37 +03:00
|--------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
| **Windows** | Download and run [hledger-0.26-win64.exe ](http://hledger.org/downloads/hledger-0.26-win64.exe ) <!-- (or the [32-bit build ](http://hledger.org/downloads/hledger-0.26-win32.exe )) --> & [hledger-web-0.26-win64.exe ](http://hledger.org/downloads/hledger-web-0.26-win64.exe ) (old), or the [latest development builds ](developer-guide.html ). hledger-ui does not run on Windows.
| **Mac** | `brew install hledger` < br > 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` < br > 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 \` < br > `nixpkgs.haskellPackages.hledger-ui \`< br > `nixpkgs.haskellPackages.hledger-web`
2014-11-05 08:18:13 +03:00
2014-11-11 00:38:05 +03:00
<!--
2015-07-23 17:05:28 +03:00
**on another GNU/Linux\<small>(or can run Linux binaries)</ small > **
2014-11-11 00:38:05 +03:00
[hledger.linux-32.zip]()
[hledger-web.linux-32.zip]()
[hledger.linux-64.zip]()
[hledger-web.linux-64.zip]()
Use cabal
-->
2015-07-23 01:19:41 +03:00
<!--
2015-07-23 17:05:28 +03:00
Building and supporting Windows and Mac binaries is costly, so
it's demand-driven - you can indicate demand by making a project
donation of any size. Binaries funded in this way will be linked here.
This is a quick way to help the project and your fellow users!
2015-07-23 01:19:41 +03:00
-->
2014-11-13 05:02:40 +03:00
2015-11-10 01:10:59 +03:00
< a name = "released" > < / a >
2016-04-16 16:19:43 +03:00
## I want to build the latest released version
2014-11-11 00:38:05 +03:00
2016-09-13 19:00:17 +03:00
The latest release may be newer than your OS's packaged version.
2016-09-13 19:29:23 +03:00
Here are the latest [release notes ](release-notes.html ).
2015-07-22 23:58:10 +03:00
2016-09-13 19:29:23 +03:00
1. Install [`stack` ](http://haskellstack.org ) to make building easier.
On Windows, the 64-bit version is [recommended ](https://github.com/simonmichael/hledger/issues/275#issuecomment-123834252 ).
2016-09-13 19:00:17 +03:00
2016-09-13 19:29:23 +03:00
2. `stack setup` \
to ensure you have a suitable version of [GHC ](https://www.haskell.org/ghc ).
2016-09-13 19:00:17 +03:00
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` ,
2016-09-13 19:29:23 +03:00
configure that, so that commands like `hledger` will work.
2016-09-13 19:00:17 +03:00
Eg if you're a bash user:\
`echo "export PATH=$PATH:~/.local/bin" >> ~/.bashrc && source ~/.bashrc`
Or use [`cabal` ](https://www.haskell.org/cabal/ ) if you prefer and know how.
It's harder to use and to support, so these docs focus on stack.
2016-09-13 22:08:37 +03:00
Haskell builds can fail due to missing C libraries or headers, which stack/cabal can not install.
2016-09-13 19:29:23 +03:00
If you have this problem, here are some C libs you might need (please send updates):
2016-09-13 19:00:17 +03:00
|
2016-09-13 22:08:37 +03:00
|--------------------|-----------------------------------
| **Debian, Ubuntu** | `sudo apt install ... ?`
| **Fedora, RHEL** | `sudo dnf install ncurses-devel`
2015-07-14 07:56:39 +03:00
2016-09-13 19:00:17 +03:00
< a name = "unreleased" > < / a >
## I want to build the [latest development version](https://github.com/simonmichael/hledger/commits/master)
2016-09-13 22:08:37 +03:00
This includes the latest features and is normally stable enough for daily use (it's what I use).
2016-09-13 19:00:17 +03:00
<!-- See also the [Developer Guide ](http://hledger.org/developer-guide.html ). -->
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.
<!--
Detailed cabal instructions:
2015-11-06 06:33:57 +03:00
1. Install [GHC ](http://haskell.org/ghc ) and [cabal ](http://haskell.org/cabal/download.html ) if needed.
2. Ensure `~/.cabal/bin` or the Windows equivalent is in your `$PATH` .
3. `cabal update`
4. `cabal install alex happy`
2015-11-07 22:22:57 +03:00
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 ](https://github.com/coreyoconnor/vty/pull/1 ).)
9. Ensure this `.../hledger-sandbox/.cabal-sandbox/bin` is in your `$PATH` (or move its contents to ~/.cabal/bin).
2016-09-13 19:00:17 +03:00
-->
<!--
2016-02-21 03:59:56 +03:00
**in a VM**
- if stack or cabal can't run on your OS, maybe this [vagrant image ](https://github.com/sciurus/hledger-vagrant ) can ?
2016-04-16 16:19:43 +03:00
-->