## Release notes
**hledger-web packaging fixes for stackage; misc dependency and doc updates**
### hledger 1.52.4
Improvements
- Allow megaparsec 9.8.1+ (but not 9.8.0, because of [megaparsec#572](https://github.com/mrkkrp/megaparsec/issues/572)).
Docs
- csv: the manual now correctly documents that most top-level rules are evaluated first-wins, not last-wins as previously stated.
(Accepting the status quo, unlike hledger 2.x where they are changed to last-wins.) [#2539]
[#2539]: https://github.com/simonmichael/hledger/issues/2539
### hledger-ui 1.52.4
Improvements
- Allow megaparsec 9.8.1+ (but not 9.8.0, because of [megaparsec#572](https://github.com/mrkkrp/megaparsec/issues/572)).
- Allow vty 6.6+, and drop the upper bounds on vty, vty-crossplatform and vty-windows.
### hledger-web 1.52.4
Fixes
- Raise aeson's lower bound to `>=2.2.5.1`, avoiding versions vulnerable to denial-of-service.
(<https: haskell.github.io security-advisories advisory hsec-2026-0007.html>)
Improvements
- The yesod-static and hjsmin dependencies have been dropped;
hledger-web now serves its static files itself, using wai-app-static
and file-embed. (yesod-static doesn't currently build with crypton
1.1+, which has kept it, and hledger-web, out of stackage nightly.)
Static file urls no longer include an `?etag=...` cache buster;
instead the files are served with an ETag header, and conditional
requests are answered with 304 Not Modified.
(Cherry picked from an AI-assisted change in hledger 2.x.)
- Allow megaparsec 9.8.1+ (but not 9.8.0, because of [megaparsec#572](https://github.com/mrkkrp/megaparsec/issues/572)).
- Allow yesod-core 1.7.0.0.
### project changes 1.52.4
Doc updates
- Github release install instructions have been fixed and simplified. [#2707]
[#2707]: https://github.com/simonmichael/hledger/issues/2707
### credits 1.52.4
Simon Michael.
## Install
The [hledger Install page](https://hledger.org/install) lists the easiest ways to install a recent release,
such as `brew` on macos, `choco`/`scoop`/`winget` on Windows, or `eget` on all platforms.
Or, follow these instructions to install the specific release binaries below:
Updates to binaries:
- 2026-01-12: Fixed the hledger-linux-x64.tar.gz asset below, it previously contained a dev build. [#2526](https://github.com/hledgerorg/hledger/issues/2526)
### GNU/Linux, 64-bit Intel
At the command line:
curl -fL https://github.com/hledgerorg/hledger/releases/download/1.52.4/hledger-linux-x64.tar.gz | tar -xzv -f- -C/usr/local/bin hledger hledger-ui hledger-web
hledger --version; hledger-ui --version; hledger-web --version # should show 1.52.4
Prefix `tar` with `sudo` if `/usr/local/bin` is not writable.
### Mac, 64-bit ARM or Intel
Open a terminal window.
(Don't download these binaries with your web browser - they won't get authorised.)
On ARM macs:
sudo mkdir -p /usr/local/bin
curl -fL https://github.com/hledgerorg/hledger/releases/download/1.52.4/hledger-mac-arm64.tar.gz | sudo tar -xzv -f- -C/usr/local/bin hledger hledger-ui hledger-web
hledger --version; hledger-ui --version; hledger-web --version # should show 1.52.4
On Intel macs:
sudo mkdir -p /usr/local/bin
curl -fL https://github.com/hledgerorg/hledger/releases/download/1.52.4/hledger-mac-x64.tar.gz | sudo tar -xzv -f- -C/usr/local/bin hledger hledger-ui hledger-web
hledger --version; hledger-ui --version; hledger-web --version # should show 1.52.4
If the version check shows an older version, you have another hledger earlier in `$PATH`; `which -a hledger` will find it.
### Windows, 64-bit ARM or Intel
In a powershell window (press `WINDOWS-R`, `powershell`, `ENTER`).
(Don't download the zip with your web browser - programs downloaded that way may be blocked when you run them.)
cd ~
curl.exe -fLO https://github.com/hledgerorg/hledger/releases/download/1.52.4/hledger-windows-x64.zip
Expand-Archive hledger-windows-x64.zip -Force -DestinationPath "$env:LOCALAPPDATA\Programs\hledger"
`$env:LOCALAPPDATA\Programs\hledger` (ie `C:\Users\YOURNAME\AppData\Local\Programs\hledger`) is not in `$env:Path` by default,
so if `$env:Path` doesn't show it, add it once:
[Environment]::SetEnvironmentVariable('Path', "$env:LOCALAPPDATA\Programs\hledger;" + [Environment]::GetEnvironmentVariable('Path','User'), 'User')
$env:Path = "$env:LOCALAPPDATA\Programs\hledger;$env:Path" # for this window; new windows will pick it up automatically
Then:
hledger --version; hledger-ui --version; hledger-web --version # should show 1.52.4
If the version check shows an older version, you have another hledger earlier in `$env:Path`; `where.exe hledger` will find it.
These are 64-bit Intel binaries; they also run on ARM machines (emulated).
They may also work on Windows 7:
use Windows Explorer to extract `hledger-windows-x64.zip` into a folder of your choice,
then open a command window (`WINDOWS-R`, `cmd`, `ENTER`) and run the hledger programs.
### Next steps
Once installed, run `hledger`,
and see the [hledger Docs](https://hledger.org/doc.html).
Source: README.md, updated 2026-09-10
