A small container which generates example beancount ledger files and makes them available over HTTP. Primarily used in test environments which test against beancount data.

Run the container:

docker run -p 8001:8001 jmgilman/beancount-example # or ghcr.io/jmgilman/beancount-example

The generated beancount data can be accessed at the root path:

curl http://localhost:8001/

By default, the example data is only generated once and then reused across requests. This is helpful in test scenarios where you need the backing data to remain unchanged.

To override this behavior and force the data to be regenerated, simply provide the following query parameter with the request:

curl http://localhost:8001/?reset

This can be called any number of times with the backing data being regenerated each time the query parameter is appended.

The following optional environment variables can be set for controlling generation:

Note that unset values are randomly generated.