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.