This project is not maintained anymore and is abandoned. Feel free to fork and make your own changes, or you can switch to the official image.

Docker image for Spliit, an open source alternative to Splitwise.

• Build locally
• Image
• Environment variables
• Ports
• Usage
  • Docker Compose
• Upgrade
• Contributing
• License

git clone https://github.com/crazy-max/docker-spliit.git
cd docker-spliit

# Build image and output to docker (default)
docker buildx bake

# Build multi-platform image
docker buildx bake image-all

The following platforms for this image are available:

$ docker buildx imagetools inspect crazymax/spliit --format "{{json .Manifest}}" | \
  jq -r '.manifests[] | select(.platform.os != null and .platform.os != "unknown") | .platform | "\(.os)/\(.architecture)\(if .variant then "/" + .variant else "" end)"'

linux/amd64
linux/arm64

• TZ: The timezone assigned to the container (default UTC)
• POSTGRES_HOST: Hostname of the database server (default db)
• POSTGRES_PORT: Port where the database server is reachable (default 5432)
• POSTGRES_USER: Username for database (default spliit)
• POSTGRES_DB: Database name (default spliit)
• POSTGRES_TIMEOUT: Time in seconds after which we stop trying to reach the database server (default 60)
• POSTGRES_PASSWORD: Password for database user (default empty)

• 3000/tcp: HTTP port

Docker compose is the recommended way to run this image. You can use the following docker compose template, then run the container:

docker compose up -d
docker compose logs -f

To upgrade, pull the newer image and launch the container:

docker compose pull
docker compose up -d

Want to contribute? Awesome! The most basic way to show your support is to star the project, or to raise issues. You can also support this project by becoming a sponsor on GitHub or by making a PayPal donation to ensure this journey continues indefinitely!

Thanks again for your support, it is much appreciated! 🙏

MIT. See LICENSE for more details.