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).
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
hledger-ui 1.52.4
Improvements
- Allow megaparsec 9.8.1+ (but not 9.8.0, because of megaparsec#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).
- Allow yesod-core 1.7.0.0.
project changes 1.52.4
Doc updates
- Github release install instructions have been fixed and simplified. #2707
credits 1.52.4
Simon Michael.
Install
The hledger Install page 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
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.
