2022-07-26 14:44:04 +03:00
< details >
< summary >
## Release notes (https://hledger.org/release-notes.html#hledger-A-BB)
< / summary >
2022-07-31 08:55:59 +03:00
<!-- release - notes.md section goes here -->
2022-07-26 14:44:04 +03:00
< / details >
## Installing
At < https: / / hledger . org / install > , binary packages should be available for this release within a few days (look for green badges).
Or, you can build from source as described there, after cloning at tag `A.BB` :
`git clone https://github.com/simonmichael/hledger --depth 1 -b A.BB`
2022-07-27 02:17:07 +03:00
Or, if under "Assets" below there are release binaries suitable for your OS and hardware, you can use those.
2022-07-26 14:44:04 +03:00
<!--
2022-08-01 01:35:42 +03:00
Note: release binaries have been updated:
2022-07-26 14:44:04 +03:00
- YYYY-MM-DD: description. [#NNNN ](https://github.com/simonmichael/hledger/issues/NNNN )
-->
2022-07-27 02:17:07 +03:00
Here are platform-specific instructions for the release binaries.
2022-07-31 08:55:59 +03:00
(You can copy & paste each block of commands as a unit to save time.):
2022-07-26 14:44:04 +03:00
< details >
< summary >
### GNU/Linux on 64-bit Intel
< / summary >
At the command line,
```
2022-07-27 01:27:53 +03:00
cd /usr/local/bin
2022-07-31 08:55:59 +03:00
curl -LOC- https://github.com/simonmichael/hledger/releases/download/A.BB/hledger-linux-x64.zip # can rerun if interrupted
2022-07-27 01:27:53 +03:00
unzip hledger-linux-x64.zip; tar xvf hledger-linux-x64.tar; rm hledger-linux-x64.{zip,tar} # github workaround, preserves permissions
cd -
hledger --version # should show the new version
touch $HOME/.hledger.journal # ensure a default journal file exists
2022-07-26 14:44:04 +03:00
```
< / details >
< details >
< summary >
### Mac on 64-bit Intel
< / summary >
In a terminal window,
```
2022-07-27 01:27:53 +03:00
cd /usr/local/bin
curl -LOC- https://github.com/simonmichael/hledger/releases/download/A.BB/hledger-mac-x64.zip
unzip hledger-mac-x64.zip; tar xvf hledger-mac-x64.tar; rm hledger-mac-x64.{zip,tar} # github workaround, preserves permissions
open .
2022-07-31 08:55:59 +03:00
# for the hledger, hledger-ui, hledger-web icons: right-click, Open, confirm it's ok to run
2022-07-27 01:27:53 +03:00
cd -
hledger --version # should show the new version
touch $HOME/.hledger.journal # ensure a default journal file exists
2022-07-26 14:44:04 +03:00
```
< / details >
< details >
< summary >
2022-07-26 19:56:31 +03:00
### Windows on 64-bit Intel
< / summary >
In a powershell window (press Windows-r, type powershell, press enter),
2022-07-27 02:17:07 +03:00
Make a place to keep hledger binaries, and add it to your PATH; this makes running hledger easier. You only need to do this once, not for every release:
2022-07-26 19:56:31 +03:00
```
mkdir -force $HOME\bin >$null
2022-07-27 01:52:58 +03:00
$ENV:PATH += ";"+$HOME+"\bin"
2022-07-27 02:17:07 +03:00
[Environment]::SetEnvironmentVariable("Path", [Environment]::GetEnvironmentVariable("Path", [EnvironmentVariableTarget]::User)+";"+$HOME+"\bin", [EnvironmentVariableTarget]::User)
2022-07-26 19:56:31 +03:00
```
Download and install the release binaries:
```
cd $HOME\bin
curl https://github.com/simonmichael/hledger/releases/download/A.BB/hledger-windows-x64.zip -OutFile hledger-windows-x64.zip
Expand-Archive hledger-windows-x64.zip -DestinationPath .
rm hledger-windows-x64.zip
cd $HOME
hledger --version # should show the new version
```
And ensure a default journal file exists:
```
2022-07-27 01:52:58 +03:00
out-file -append -encoding ascii $HOME/.hledger.journal
2022-07-26 19:56:31 +03:00
```
Problems:
- Starting hledger/hledger-web by double-clicking their icon won't work; run them from a cmd or powershell window instead.
< / details >
< details >
< summary >
2022-07-26 14:44:04 +03:00
### Windows 7 on 64-bit Intel, using Firefox
< / summary >
- click hledger-windows-x64.zip below
- choose Open with Windows Explorer, OK
- click Extract all files
- choose a destination folder - ideally one that appears in `echo %PATH%` , like `C:\Windows` (though that one will require administrator permission); otherwise, your home directory (`C:\Users\YOURNAME`)
- check "Show extracted files when complete"
- click Extract, wait for the destination folder to open
- find the hledger, hledger-web icons (if you extracted to `\Windows` , you'll need to scroll down)
- for each icon: double-click, uncheck "Always ask before opening this file", click Run
- close those Explorer windows
- open a command window (press Windows-r, type CMD, press enter)
- `hledger --version` should show the new version
- `echo # >> .hledger.journal` to ensure a default journal file exists. (Important: the doubled ** >>** is needed to avoid overwriting existing data.)
Problems:
- Starting hledger by double-clicking its icon won't work because it needs arguments; run it from the command window instead.
2022-07-26 19:56:31 +03:00
- Starting hledger-web by double-clicking its icon may fail eg because Explorer's command window is too small;
configure that to be larger, or run hledger-web from a command window instead.
2022-07-26 14:44:04 +03:00
- hledger or hledger-web may fail to run if there is not enough memory available.
< / details >
## Next steps
2022-09-02 03:28:18 +03:00
- [Getting Started ](https://hledger.org/start.html )
2022-07-26 14:44:04 +03:00
<!--
## Updates
2022-06-05: linux-x64 binaries updated to run at normal speed. [#1867 ](https://github.com/simonmichael/hledger/issues/1867 )
2022-06-08: windows-x64 binaries fixed. [#1869 ](https://github.com/simonmichael/hledger/issues/1869 )
-->