Note

This repository will not be maintained. Refer instead to bharathcs/hledger-docker, published on as bharathcs2401/hledger, which has multi-platform support (including arm64 and amd64) for its images and more customisability available.

For a drop in replacement:

docker run \
  --volume='/path/to/hledger-data:/data' \
  --publish='5004:5000' \
  -d bharathcs2401/hledger:1.34 \
  hledger-web --serve --host=0.0.0.0 port=5000 --file='/data/main.ledger'

# docker-compose.yml
services:
  hledger-web:
    image: bharathcs2401/hledger:1.34
    volumes:
      - /path/to/hledger-data:/data
    ports:
      - 5000
    command: hledger-web --serve --host=0.0.0.0 port=5000 --file='/data/main.ledger'

Docker image for hledger and associated tools

Note this repository is only a fork of adept/hledger-docker. It exists to provide arm64v8 support (e.g. Raspberry Pi)

This docker image provides hledger, the plain text accounting software, and associated tools:

hledger-web, the web interface for hledger
hledger-ui, the curses interface for hledger
hledger-iadd, the interactive console frontend for "hledger add"
hledger-diff, the tool to diff journal files
hledger-interest, tool to compute interest for loan/mortgage accounts

Image versions/tags

Most recent: latest,1.33,latest-dev,1.33-dev
Legacy: 1.32.3,1.32.3-dev,1.32.2,1.32.2-dev,1.32.1,1.32.1-dev,1.31,1.31-dev,1.30.1,1.30.1-dev,1.29.2,1.29.2-dev,1.29.1,1.29.1-dev,1.28,1.28-dev,1.27.1,1.27.1-dev,1.27,1.27-dev,1.26,1.26-dev,1.25,1.25-dev,1.24.1,1.24.1-dev,1.24,1.24-dev,1.23,1.23-dev,1.22.2,1.22.2-dev,1.22.1,1.22.1-dev,1.22,1.22-dev,1.21,1.21-dev,1.20.4,1.20.4-dev,1.20.3,1.20.3-dev,1.20.2,1.20.2-dev,1.20,1.20-dev,1.19.1,1.19.1-dev,1.19,1.19-dev,1.18.1,1.18.1-dev,1.18,1.18-dev,1.17.1.1,1.17,1.16.2,1.16.1,1.15.2,1.15.1,1.14,1.14.1,1.14.2

Usage

Hledger-web

By default, container will start hledger-web on port 5000, reading journal hledger.journal from volume data, so assuming your journal is in ~/journals/all.journal, you can run:

docker run --rm -d -e HLEDGER_JOURNAL_FILE=/data/all.journal -v "$HOME/journals:/data" -p 5000:5000 --user $(id --user) bharathcs2401/hledger-arm64v8

and navigate to http://localhost:5000 for hledger-web

If you have LEDGER_FILE environmed variable defined already, you can try:

docker run --rm -d -e HLEDGER_JOURNAL_FILE=/data/$(basename $LEDGER_FILE) -v "$(dirname $LEDGER_FILE):/data" -p 5000:5000 --user $(id --user) bharathcs2401/hledger-arm64v8

Any extra arguments you provide will be passed to hledger-web.

Github repo contains helper script that simplifies invocation:

./run.sh ~/journals/all.journal web

Environment variables

HLEDGER_JOURNAL_FILE
- input file (default: /data/hledger.journal)
HLEDGER_HOST
- set the TCP host (default: 0.0.0.0)
HLEDGER_PORT
- set the TCP port (default: 5000)
HLEDGER_DEBUG
- debug output (default: 1, increase for more)
HLEDGER_BASE_URL
- set the base url (default: http://localhost:$HLEDGER_PORT)
HLEDGER_RULES_FILE
- CSV conversion rules file (default: /data/hledger.rules)
HLEDGER_ARGS
- extra arguments you want to pass to hledger-web. You can supply extra arguments on the command line as well, but environment variable is useful for docker-compose recipes.

hledger cli in the shell

You can use this image to run command-line version of hledger (or hledger-iadd, hledger-ui, ...) by providing alternative start command to docker run.

You can just drop into a shell in the container and run hledger there (remember to include -it):

docker run --rm -it -v "$HOME/hledger-data:/data" --user $(id --user) bharathcs2401/hledger-arm64v8 bash

Github repo contains helper script that simplifies invocation:

./run.sh ~/journals/all.journal bash

hledger cli via docker run

You can use docker run to invoke hledger directly:

docker run --rm -v "$HOME/hledger-data:/data" --user $(id --user) bharathcs2401/hledger-arm64v8 hledger -f /data/hledger.journal stats

Make sure you provide --rm argument to docker run, otherwise your containers will be kept in the container registry even after you are done with them, which is probably not what you want.

Using image for hledger development

You can use the supplied Dockerfile to get yourself an image for hledger development. Build target dev will get you Debian-based image with stack and all the build dependencies of hledger installed:

docker image build --tag hledger-dev --target dev .

Alternatively, you can use pre-built image via latest-dev or VERSION-dev tags:

docker run --rm -it -v "$HOME/hledger-data:/data" bharathcs2401/hledger-arm64v8:latest-dev bash

bharathcs/hledger-docker-arm64v8