Install on Linux
Put Ledgerbook on a Linux computer in about two minutes. No root password, no extra packages.
What you need
- A Linux computer with Python 3.8 or newer. Ubuntu, Mint, Fedora, Debian and most others already have it.
- Any web browser. Ledgerbook draws its screen in a browser window, but it only talks to your own computer.
Install it
- Download ledgerbook-v1.22.zip from the downloads page.
-
Open a terminal in the folder where the file landed, usually
Downloads, and unzip it:unzip ledgerbook-v1.22.zip -
Go into the new folder and run the installer:
cd ledgerbook ./install.shIt answers
✓ Ledgerbook v1.22 installed.and tells you where your data will live. -
Open Ledgerbook from your applications menu. You can also type
ledgerbookin a terminal.
If Chromium, Chrome, Brave, Edge or Vivaldi is installed, Ledgerbook opens in its own window, like any other program. Otherwise it opens as a tab in your usual browser at http://127.0.0.1:8765/.
Want to look before you install?
In the unzipped folder, run python3 ledgerbook.py. It starts straight away without installing anything. The live demo shows the same screens in your browser.
What the installer does
It copies three files into your home folder and adds a menu entry. Nothing is installed system-wide.
| What | Where |
|---|---|
| The program | ~/.local/share/ledgerbook-app/ |
The ledgerbook command |
~/.local/bin/ledgerbook |
| The menu entry | ~/.local/share/applications/ledgerbook.desktop |
| Your data, created on first run | ~/.local/share/ledgerbook/data.json |
Closing and quitting
Closing the window leaves Ledgerbook running quietly in the background, and opening it again brings the window straight back. To stop it completely, click the power button at the top right of the screen. Your data is saved as you type, so there is no Save button.
If something goes wrong
python3 is required: install Python first, for examplesudo apt install python3on Ubuntu or Mint.ledgerbook: command not found: your system doesn’t look in~/.local/bin. Use the applications menu, or runpython3 ~/.local/share/ledgerbook-app/ledgerbook.py.Permission deniedon./install.sh: runbash install.shinstead.- A blank page or “can’t connect”: the background program isn’t running. Open Ledgerbook from the menu again.
Next: set up your book.