> OpenCount is a free, open-source, self-hosted Tricount and Splitwise alternative. Split expenses with friends, see who owes whom, settle up in the fewest payments. Repeating expenses, local receipt reading, insights, an installable phone app. One Docker container, one SQLite file.
> Source: https://orochibraru.com/opencount · Site index: https://orochibraru.com/llms.txt

# OpenCount

Split expenses with friends, see who owes whom, settle up. Tricount, minus the
company holding your friends' spending habits.

![OpenCount on a desktop and a phone](https://orochibraru.com/images/811f77fd8cf436d0125f98465dad2815e9a6172c.webp)
**Who paid, who owes.** A group per trip, flat or dinner, on a server you
already run.

## What it is

OpenCount is a self-hosted, open-source alternative to Tricount. Make a group,
log who paid for what, and it tells you who owes whom and the fewest payments
that bring everyone back to zero.

It is **one container and one SQLite file**. No database server, no cache, no
queue next to it. Emails, repeating expenses and housekeeping run in a worker
process the server starts and watches inside the same container.

It's built for a household, a group of friends or a small association: a
handful to a few dozen people who trust one person to run the box. That person
is you, presumably.

## Showcase

Every screen below comes out of the repo: `mise run screenshots` retakes them
against a seeded instance. Every name, group and amount is made up.

![The groups list](https://orochibraru.com/images/31b7ab97c61d20d0b59560218bacaaf7cbde3e68.webp)
**Groups** Each group you're in, who's in it, and your balance at a glance:
what you're owed, or what you owe.

![A group's expenses](https://orochibraru.com/images/5bf71409cc665383b1624d95fada71989e008f06.webp)
**Expenses** Newest first, your balance on top, a shortcut to settle up. Add,
edit or delete in place.

![A group's insights](https://orochibraru.com/images/01e452399905117905010f7c69fe32e86135d94e.webp)
**Insights** Spending by period, category, merchant and payer, and how it moved
over time.

![A group's members](https://orochibraru.com/images/ffefde5050d16c8b11f0628155ca4cda2b54913c.webp)
**Group settings** Name, currency, members, the group's own categories and its
repeating expenses. Members added by name show **No account linked** until
someone claims them.

![Adding an expense on a phone](https://orochibraru.com/images/224e7c85f3b2de399e0407588386b6f3645ae505.webp)
**On a phone** A bottom tab bar, a floating button to add an expense, and a
sheet that slides up to fill it in. The category is guessed as you type.

![The admin area](https://orochibraru.com/images/ddeb597a7a4d4d0bda4473e96da11cc7a4831b99.webp)
**Administration** Setup checklist, users, invites, sign-in methods, email and
receipt reading. Admins only.

The rest, phone screens included, is in the
[full showcase](https://orochibraru.com/opencount/docs/showcase).

## Features

### Groups

One per trip, flat or dinner, in one of twelve currencies. Add people by name
before they have an account; they claim it with **That's me** once they join.

### Splits that add up

Equally, by shares or by exact amounts, between everyone or only some. Amounts
are whole cents, so a split never loses a cent to rounding.

### Settle up

Everyone's balance, and the fewest payments that zero the group. Recording one
takes a tap.

### Repeating expenses

Rent and subscriptions every week, month or year, anchored to their day of the
month, with pause and resume.

### Less typing

Categories guessed from the description in English and French, merchants
remembered per group, custom categories per group.

### Receipt reading, locally

A photo or a PDF fills in the amount, date and merchant. Read on your server by
Tesseract, never stored, never sent anywhere. Off by default.

### Insights

By period, category, merchant and payer, and over time. Find out who keeps
buying the drinks.

### Archiving

Hide a finished group from your own list without touching anyone else's.

### Feels native

An installable PWA: tab bar and sheets on a phone, a sidebar on a desktop.
Accent colour, light, dark or AMOLED, font and corners, per account.

### Invite-only by default

Invites, sign-ups once email works, required authenticator apps or passkeys,
and single sign-on through any OpenID Connect provider. All from the admin area.

## Run it

Make an empty directory and put two files in it.

### compose.yaml

```yaml
services:
  opencount:
    image: docker.io/orochibraru/opencount:latest
    restart: unless-stopped
    ports:
      - 3000:3000
    volumes:
      - opencount:/data
    environment:
      AUTH_SECRET: ${AUTH_SECRET:?set AUTH_SECRET, e.g. openssl rand -base64 32}
      # The URL people open, like https://opencount.example.com.
      ORIGIN: ${ORIGIN:-}

volumes:
  opencount: {}
```

### .env

```bash
cat > .env <<EOF
AUTH_SECRET=$(openssl rand -base64 32)
ORIGIN=https://opencount.example.com
EOF
```

### Start it

```bash
docker compose up -d
```

The image is built for `linux/amd64` and `linux/arm64`. Put it behind an HTTPS
reverse proxy: passkeys and installing the app both need HTTPS.

Keep `AUTH_SECRET` with your backups. It signs sessions and encrypts the secrets
stored in the database; change it and everyone is signed out and those secrets
are gone.

### First run

A fresh instance sends every page to a setup screen that asks for a six-digit
code only the server's log shows, so nobody who stumbles on the URL can claim
it:

```bash
docker compose logs opencount
```

The first account is the admin. The [install guide](https://orochibraru.com/opencount/docs/install)
and [first run](https://orochibraru.com/opencount/docs/first-run) walk through the rest, and
[configuration](https://orochibraru.com/opencount/docs/configuration) covers every variable.

## How it's built

- **App**: SvelteKit with Svelte 5, TailwindCSS and shadcn-svelte, installable
  as a PWA
- **Database**: SQLite with Drizzle ORM, migrations at boot
- **Auth**: Better Auth, with passkeys, two-factor and OpenID Connect
- **Background work**: a compiled Bun worker in the same container
- **Receipts**: Tesseract and Poppler, local only
- **Observability**: structured logs, OpenTelemetry traces, optional Sentry

## Honest status

It's new. The code works and the docs are complete, but it hasn't had a year of
real groups arguing over a restaurant bill yet. Back up the volume.

What it stores, who sees it and what never leaves the server, for
`app.opencount.eu` and your own instance alike, is in the
[privacy notice](https://orochibraru.com/privacy/opencount).

MIT licensed. Free, and staying that way. [Here's why](https://orochibraru.com/#free).