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
Open the app
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
- Open Spliit from your dashboard.
- Click Create a group, name it and add the people in it.
- Share the group's link with them.
- 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
| Variable | Default value | Description |
|---|---|---|
TZ | $TZ | Your time zone. It is filled in from your ZimaOS time zone. |
DEFAULT_ | USD | The currency picked for new groups, like USD, EUR, GBP, INR or NZD. Each group can use its own. |
Server
| Variable | Default value | Description |
|---|---|---|
BASE_ | http://localhost:6787 | The address you open Spliit at, like http://192.168.1.20:6787. Used in shared links and the web app manifest. |
Features
| Variable | Default value | Description |
|---|---|---|
ENABLE_ | false | Set to true to let people delete groups. |
ENABLE_ | false | Set to true to attach receipt images (needs the S3 settings below). |
S3_ | — | S3 access key, for receipt images. |
S3_ | — | S3 secret key. |
S3_ | — | S3 bucket name. |
S3_ | — | S3 region, like us-east-1. |
S3_ | — | S3 server address, for providers other than AWS. |
AI
| Variable | Default value | Description |
|---|---|---|
ENABLE_ | false | Set to true to fill in expenses from a photo of the receipt (needs receipt images and OPENAI_API_KEY). |
ENABLE_ | false | Set to true to suggest a category from the expense's title (needs OPENAI_API_KEY). |
OPENAI_ | — | Your OpenAI API key, or a key for OPENAI_BASE_URL. |
OPENAI_ | — | An OpenAI-compatible server, like a local Ollama. Leave it out for OpenAI. |
Analytics
| Variable | Default value | Description |
|---|---|---|
ANALYTICS_ | — | plausible or umami, to count visits. Leave it out for none. |
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.
ZimaOS
Add the store link, then find Spliit in the App Store and install it.
CasaOS
Add the store link, then find Spliit in the App Store and install it.
ReCasaOS
Add the store link, then find Spliit in the App Store and install it.
Homeio
Add the store link, then find Spliit in the App Store and install it.
MOS
Add the repository in MOS Hub Settings, then find Spliit in Docker → MOS Hub and install it.
