diff --git a/site/download.md b/site/download.md index 4b69e7f15..4f2cbb982 100644 --- a/site/download.md +++ b/site/download.md @@ -1,10 +1,11 @@ # Download -There are lots of ways to install hledger. -Here they are, organised by platform, with the usually most up-to-date methods at the top. +Here are the ways to install hledger, organised by platform, with the usually most up-to-date methods at the top. Note the first three involve building from source, which is slower. -Please [send updates](https://github.com/simonmichael/hledger/edit/master/site/download.md) for this page, +Please [send updates](index.html#helpfeedback) for +[this page](https://github.com/simonmichael/hledger/blob/master/site/download.md), and help packagers keep their platform packages up to date. +hledger's usual release window is the first day or two of the month. +| | | Latest release is 1.14.1
([release notes](http://hledger.org/release-notes)) |--------------------------------|------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------- -|
**Multiplatform** | |
*This method builds:* -| [hledger-install.sh](#b1)
*Linux, Mac, WSL* | Builds the latest release from source, avoids common pitfalls, requires only bash, takes a while. In case of trouble, see [Building from source](#b).
**`curl -sO https://raw.githubusercontent.com/simonmichael/hledger/master/hledger-install/hledger-install.sh`**
**`less hledger-install.sh`** *# satisfy yourself that the script is safe*
**`bash hledger-install.sh`** | Latest release -| [stack install](#b2)
*Linux, Mac, Windows* | Builds any version from source, requires stack. See [Building from source](#b).
| Latest release, or any version -| [cabal install](#b3)
*Linux, Mac, Windows* | Builds any version from source, requires cabal and GHC. See [Building from source](#b).
| Latest release, or any version -| [Docker][]
*Linux, Mac, Windows* | **`docker pull dastapov/hledger`** ([image info](https://hub.docker.com/r/dastapov/hledger), [more images](https://hub.docker.com/search?q=hledger&type=image&sort=updated_at&order=desc)) | 1.14.1 +|
**Multiplatform** | |
*This method installs:* +| [hledger-install.sh](#b1)
*Linux, Mac, WSL* | Requires bash. Builds the latest release from source, avoiding common pitfalls. In case of trouble, see [Building from source](#b).
**`curl -sO https://raw.githubusercontent.com/simonmichael/hledger/master/hledger-install/hledger-install.sh`**
**`less hledger-install.sh`** *# satisfy yourself that the script is safe*
**`bash hledger-install.sh`** | Latest release +| [stack install](#b2)
*Linux, Mac, Windows* | Requires stack. See [Building from source](#b).
| Latest release, or any version +| [cabal install](#b3)
*Linux, Mac, Windows* | Requires cabal and GHC. See [Building from source](#b).
| Latest release, or any version +| [Docker][]
*Linux, Mac, Windows* | **`docker pull dastapov/hledger`** ([readme](https://hub.docker.com/r/dastapov/hledger), [more images](https://hub.docker.com/search?q=hledger&type=image&sort=updated_at&order=desc)) | 1.14.1 | [Nix][]
*Linux, Mac* | **`nix-env -i hledger hledger-ui hledger-web`** | [![nixpkgs unstable](https://repology.org/badge/version-for-repo/nix_unstable/hledger.svg)](http://hydra.nixos.org/search?query=hledger) [![nixpkgs stable](https://repology.org/badge/version-for-repo/nix_stable/hledger.svg)](http://hydra.nixos.org/search?query=hledger) |
**Mac** | | [Homebrew][] | **`brew install hledger`** | [![Homebrew](https://repology.org/badge/version-for-repo/homebrew/hledger.svg)](https://repology.org/metapackage/hledger/versions) |
**Windows** | | [Linuxbrew][] | **`brew install hledger`** | [![Linuxbrew](https://repology.org/badge/version-for-repo/linuxbrew/hledger.svg)](https://repology.org/metapackage/hledger/versions) -| [Windows binaries][] | **[hledger.zip](https://ci.appveyor.com/api/buildjobs/vcocma20843lpfdo/artifacts/hledger.zip)** [no hledger-ui](https://github.com/jtdaugherty/vty/pull/1#issuecomment-297143444),[doesn't work on old windows ?](https://github.com/simonmichael/hledger/issues/774),[many files in PATH causing hangs](https://github.com/simonmichael/hledger/issues/791) | 1.12 +| [Windows binaries][] | **[hledger.zip](https://ci.appveyor.com/api/buildjobs/vcocma20843lpfdo/artifacts/hledger.zip)** | 1.12 |
**GNU/Linux** | | [Linuxbrew][] | **`brew install hledger`** | [![Linuxbrew](https://repology.org/badge/version-for-repo/linuxbrew/hledger.svg)](https://repology.org/metapackage/hledger/versions) | [Arch][] | **`pacman -S hledger hledger-ui hledger-web`** | [![Arch](https://repology.org/badge/version-for-repo/arch/hledger.svg)](https://repology.org/metapackage/hledger/versions) @@ -66,7 +67,7 @@ a { white-space:nowrap; } |
**BSD** | | OpenBSD | Ports: **[https://github.com/jasperla/openbsd-wip/pull/104](https://github.com/jasperla/openbsd-wip/pull/104)**
Third-party binaries: **[OpenBSD6.3/amd64](https://s3.amazonaws.com/openbsd-hledger/index.html)** | 1.10 |
**Other** | -| [Sandstorm][]
*Community/private cloud platform* | **[hledger-web Sandstorm app](https://apps.sandstorm.io/app/8x12h6p0x0nrzk73hfq6zh2jxtgyzzcty7qsatkg7jfg2mzw5n90)**
[features needed](https://github.com/simonmichael/hledger/issues/425) | 1.9.2 +| [Sandstorm][]
*Community/private cloud platform* | **[hledger-web Sandstorm app](https://apps.sandstorm.io/app/8x12h6p0x0nrzk73hfq6zh2jxtgyzzcty7qsatkg7jfg2mzw5n90)** | 1.9.2 @@ -229,11 +230,11 @@ And you can check that the unit tests pass (just for fun): `$`**`hledger test`**\ `...`\ - `✅ 188 tests passed, no failures! 👍 🎉`\ + `✅ 198 tests passed, no failures! 👍 🎉`\ -### Build the development version +### Building the development version The master branch in hledger's git repo is stable enough for daily use, and includes the [latest improvements](https://github.com/simonmichael/hledger/commits/master). @@ -248,5 +249,5 @@ This will build and install all of the main hledger tools using stack: cabal users may find the `cabal-install.sh` or `cabal.project` files useful. The --version output of development builds has a .99 suffix meaning "dev". -So 1.14.99 means "1.15-dev", ie the in-development version of 1.15. +So 1.14.99 means "1.15-dev", the in-development version of 1.15.