Skip to content
geeForceOnePublic

About

Simple, self-hosted bookkeeping: accounts, positions, recurring bookings and email reports. Blazor + Docker.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

LaLira

Simple, self-hosted bookkeeping for your accounts. Each account has a currency, a starting balance and a list of money in and out with a running balance; earlier years are summed up as their year-end balance. Recurring bookings book themselves, even after the app was down, and a report arrives by email when the month is over.

The sign-in page

The overview: everything in CHF and the totals per currency, each chart showing every account as a band in its color, and every account with its balance and this month's money in and out

An account: the entry row for new positions, and the list with its running balance

A portfolio: value and gain per currency with the value over time against what was paid, the gain per year, and the entry row for a purchase

  • Accounts and positions: a date, a description and an amount (a minus means money out), typed straight into the list (dates also as digits only, like 29012016), with an optional note. The current year shows every position; older years show one 31.12. line that opens on click, or all at once, or are hidden with "Only current year".
  • Balance charts and search: the balance of each account and of each currency total over 1 year, 5 years or everything, with grid lines and amounts, and a search through an account's descriptions, notes, amounts and dates. Every account has a color; the total charts show each account as a band in it. Click a name in the legend to hide it, and group small accounts under "Others".
  • Main currency: pick one in Settings to see everything converted into it, with daily exchange rates from Frankfurter (free, no key). Amounts stay stored in their own currency.
  • Your order: sort the accounts on the overview by dragging a card or with the small arrows in its corners; the sidebar and every list follow.
  • IBAN: optional per account, checked for typos, with a copy button.
  • Portfolios: one row per purchase (date, quantity, price per share), sales in full or in part, and value and gain or loss per currency. Current prices come once a day from EODHD with your own free API key, which also lets you search for a security by name or ISIN to fill in the row. Swiss ISINs fill in the Valor. A chart shows the value over time against what you paid, with the gain per year (the free key reaches a year back), and price alerts email you when a share crosses a limit.
  • Recurring positions: weekly, monthly, quarterly or yearly, with placeholders such as Deposit {month} → "Deposit October". Missed dates are booked with their own date as soon as the app is back.
  • Email reports: monthly, quarterly or yearly: money in and out per account (and in total in your main currency), for the accounts you include.
  • CSV import and export, with a preview and duplicate detection.
  • Backups: a daily automatic backup, downloads with an optional password, and restore from the browser. Each backup also holds every account and portfolio as a CSV file, and a safety backup is made before every update.
  • English and German, with separate region formats (for example English with Swiss formats: 12’480.00, 14.10.2026).
  • Users: the first user is the admin, who invites others; optional account requests from the sign-in page. Users can't see each other's accounts and portfolios in the app (see Privacy and intended use).
  • Homepage widget: your money in and out this month on a gethomepage.dev dashboard.

Privacy and intended use

LaLira is designed to be self-hosted for a household or a small group of people who trust each other, such as a family. It is not built to be offered as a public service.

  • Data is not encrypted at rest. Accounts, positions and notes are stored in readable form in the SQLite database in the /data volume. Anyone with access to the server or to that volume can read them. (Only the SMTP password and the EODHD API keys are stored encrypted.)
  • Administrators can access all data. Users can't see each other's accounts and portfolios in the app, but every backup contains all accounts and portfolios of all users as readable CSV files, and admins can download backups.
  • Protect the host. Run LaLira on a machine you control, put it behind HTTPS if it is reachable from the internet, and store downloaded backups safely, ideally with a backup password.

Run it with Docker

services:
  lalira:
    image: ghcr.io/geeforceone/lalira:latest
    ports:
      - "8336:8080"
    volumes:
      - lalira-data:/data
    restart: unless-stopped

volumes:
  lalira-data:

Open http://localhost:8336 and create the admin user. Everything (database, keys, backups) lives in the /data volume. Keep restart: unless-stopped: a restore from the Backups page restarts the app.

To send invites, password resets and reports, enter your SMTP server under Admin settings.

Develop

dotnet build LaLira.slnx
dotnet run --project src/LaLira.Web     # http://localhost:5336, data in ./data
dotnet test tests/LaLira.Tests
docker compose up --build

.NET 10, Blazor Server, SQLite. src/LaLira.Core holds all logic (no UI), so a future mobile app can reuse it; src/LaLira.Web is the web UI and host.

License

MIT

About

Simple, self-hosted bookkeeping: accounts, positions, recurring bookings and email reports. Blazor + Docker.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages