Spliit

Share expenses with friends and family, a Splitwise alternative

  • ghcr.io/hsinghhira/spliit:1.0.1
  • v1.30.0
  • Updated 21 Nov 2026
  • port 6787
  • amd64 · arm64
  • Finance
  • 3.1k stars

Screenshots

Spliit screenshot 1: Spliit

Open the app

Web app

http://localhost:6787/

About Spliit

Spliit keeps track of shared costs: trips, rent, dinners and groceries. Add who paid what, and it works out who owes whom and the fewest payments to settle up. There are no accounts: share a group's link and everyone in it can add expenses. The PostgreSQL database is built in, so it is one container with nothing else to set up.

Features

  • Groups with any number of people, shared by a link
  • Split evenly, by shares, by percent or by amount
  • Balances and the simplest way to pay each other back
  • Categories, notes, recurring expenses and statistics
  • Many currencies and languages
  • Export to CSV and JSON, and an installable web app

How to use

  1. Open Spliit from your dashboard.
  2. Click Create a group, name it and add the people in it.
  3. Share the group's link with them.
  4. Add expenses as they happen, then open Balances to settle up.

Before you install

You can install it as it is and open it at http://[ZIMAOS-IP-ADDRESS]:6787. Set DEFAULT_CURRENCY_CODE to your currency. There are no accounts: anyone who has a group's link can open and change it, so share links only with the people in the group. The database password is made for you on first start and kept in /DATA/AppData/spliit/data. Receipt images, AI features and the other settings are in the Variables tab and are added in the app settings. It is ready in about a minute.

The settings in the first table are already in the app settings. To use any other one, open the app settings, add the variable with your value, save, and the app restarts with it. A setting you leave out uses its default.

In the app settings

VariableDefault valueDescription
TZ$TZYour time zone. It is filled in from your ZimaOS time zone.
DEFAULT_CURRENCY_CODEUSDThe currency picked for new groups, like USD, EUR, GBP, INR or NZD. Each group can use its own.

Server

VariableDefault valueDescription
BASE_URLhttp://localhost:6787The address you open Spliit at, like http://192.168.1.20:6787. Used in shared links and the web app manifest.

Features

VariableDefault valueDescription
ENABLE_GROUP_DELETIONfalseSet to true to let people delete groups.
ENABLE_EXPENSE_DOCUMENTSfalseSet to true to attach receipt images (needs the S3 settings below).
S3_UPLOAD_KEY—S3 access key, for receipt images.
S3_UPLOAD_SECRET—S3 secret key.
S3_UPLOAD_BUCKET—S3 bucket name.
S3_UPLOAD_REGION—S3 region, like us-east-1.
S3_UPLOAD_ENDPOINT—S3 server address, for providers other than AWS.

AI

VariableDefault valueDescription
ENABLE_RECEIPT_EXTRACTfalseSet to true to fill in expenses from a photo of the receipt (needs receipt images and OPENAI_API_KEY).
ENABLE_CATEGORY_EXTRACTfalseSet to true to suggest a category from the expense's title (needs OPENAI_API_KEY).
OPENAI_API_KEY—Your OpenAI API key, or a key for OPENAI_BASE_URL.
OPENAI_BASE_URL—An OpenAI-compatible server, like a local Ollama. Leave it out for OpenAI.

Analytics

VariableDefault valueDescription
ANALYTICS_PROVIDER—plausible or umami, to count visits. Leave it out for none.
docker-compose.yml
name: spliit

services:
  spliit:
    image: ghcr.io/hsinghhira/spliit:1.0.1
    container_name: spliit
    restart: unless-stopped
    stop_grace_period: 60s
    network_mode: bridge
    environment:
      - TZ=$TZ
      - DEFAULT_CURRENCY_CODE=USD
    ports:
      - target: 3000
        published: "6787"
        protocol: tcp
    volumes:
      - type: bind
        source: /DATA/AppData/$AppID/data
        target: /data
        bind:
          create_host_path: true
    healthcheck:
      test: ["CMD", "wget", "-q", "-O", "/dev/null", "http://127.0.0.1:3000/"]
      interval: 30s
      timeout: 10s
      retries: 5
      start_period: 180s
    deploy:
      resources:
        limits:
          cpus: "1.00"
          memory: 1024M
        reservations:
          cpus: "0.05"
          memory: 128M
    labels:
      icon: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/spliit/icon.png
    x-casaos:
      id: com.icestore.spliit
      envs:
        - container: TZ
          description:
            en_US: >-
              Your time zone. It is filled in from your ZimaOS time zone.
        - container: DEFAULT_CURRENCY_CODE
          description:
            en_US: >-
              The currency picked for new groups, like USD, EUR, GBP, INR or
              NZD. Each group can use its own.
      ports:
        - container: "3000"
          description:
            en_US: Spliit web app, published on host as 6787
      volumes:
        - container: /data
          description:
            en_US: >-
              The PostgreSQL database with your groups and expenses
              (postgres) and this install's own keys (secrets.env). Back it
              up.

x-casaos:
  id: com.icestore.spliit
  architectures:
    - amd64
    - arm64
  main: spliit
  author: HSinghHira
  category: Finance
  developer: Sebastien Castiel
  icon: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/spliit/icon.png
  thumbnail: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/spliit/screenshot-1.png
  screenshot_link:
    - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/spliit/screenshot-1.png
  title:
    en_US: Spliit
  tagline:
    en_US: Share expenses with friends and family, a Splitwise alternative
  description:
    en_US: >-
      Spliit keeps track of shared costs: trips, rent, dinners and
      groceries. Add who paid what, and it works out who owes whom and the
      fewest payments to settle up. There are no accounts: share a group's
      link and everyone in it can add expenses. The PostgreSQL database is
      built in, so it is one container with nothing else to set up.


      **Features**


      - Groups with any number of people, shared by a link

      - Split evenly, by shares, by percent or by amount

      - Balances and the simplest way to pay each other back

      - Categories, notes, recurring expenses and statistics

      - Many currencies and languages

      - Export to CSV and JSON, and an installable web app


      **How to use?**


      1. Open Spliit from the ZimaOS dashboard.

      2. Click Create a group, name it and add the people in it.

      3. Share the group's link with them.

      4. Add expenses as they happen, then open Balances to settle up.
  tips:
    before_install:
      en_US: >-
        1. Set DEFAULT_CURRENCY_CODE to your currency, like EUR or INR.


        2. Start the installation. It is ready in about a minute.


        3. Open http://[ZIMAOS-IP-ADDRESS]:6787 and make a group. There are
           no accounts: anyone with a group's link can open it.
  index: /
  port_map: "6787"
  scheme: http
  is_uncontrolled: false
  version: "1.30.0"
  update_at: "2026-11-21"
  release_notes:
    en_US: |-
      - First IceStore release, on port 6787
      - Built on ghcr.io/spliit-app/spliit 1.30.0, with PostgreSQL 17 inside the same container
      - Each install makes its own database password on first start
      - Fixed: every page failed with "Cannot find module ../../messages/en.json" when another app on the same address had set a NEXT_LOCALE cookie; Spliit now uses a cookie of its own.
      - The store now names the exact image version (1.0.1), so a new install downloads the fixed image instead of reusing an older one ZimaOS kept.
  repo: "https://github.com/spliit-app/spliit"
  support: "https://github.com/spliit-app/spliit/issues"
  docs: "https://github.com/spliit-app/spliit#readme"

Install Spliit

Something not working with Spliit?

Report it so it gets fixed, or ask for an app that is not here yet.

More Finance apps

See all