dnlouko/bentro-app repository overview

⁠BenTro 🍱

BenTro (Bento + Retro) is a lightweight, real-time retrospective tool designed for agile teams.

⁠🚀 Quick Start

⁠Docker Run

docker run -d \
  --name bentro-app \
  -p 8080:8080 \
  -e DB_HOST=host.docker.internal \
  -e DB_USER=postgres \
  -e DB_PASSWORD=mysecretpassword \
  -e DB_NAME=retrodb \
  dnlouko/bentro-app:v0.15.4-amd64

(Note: Replace v0.15.4-amd64 with v0.15.4-arm64 if running on Raspberry Pi / Apple Silicon)

⁠Docker Compose

version: '3.8'

services:
  app:
    # Use -amd64 for Intel/AMD processors
    # Use -arm64 for ARM processors (RPi, Apple M1/M2)
    image: dnlouko/bentro-app:v0.15.4-amd64
    ports:
      - "8080:8080"
    environment:
      - DB_HOST=postgres
      - DB_USER=postgres
      - DB_PASSWORD=postgres
      - DB_NAME=retrodb
    depends_on:
      - postgres

  postgres:
    image: postgres:15-alpine
    environment:
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=postgres
      - POSTGRES_DB=retrodb

⁠⚠️ Architecture Tags

Due to build tooling limitations, we currently provide separate tags for each architecture. Please use the specific tag for your hardware:

• x86_64 / AMD64 (Standard PC/Server): dnlouko/bentro-app:v0.15.4-amd64
• ARM64 (Raspberry Pi / Apple Silicon): dnlouko/bentro-app:v0.15.4-arm64

⁠⚙️ Environment Variables

⁠⚠️ Important: Redis Requirement (v0.16+)

Starting from v0.16.0, BenTro uses Redis for:

• Real-time synchronisation of Timers, Votes, and Card Movements across multiple instances (Kubernetes Replicas).
• Optimized WebSocket broadcasts ("Granular Updates").

⁠How to Run

With Redis (Recommended):

env:
  - name: REDIS_URL
    value: "redis://your-redis-service:6379"

Without Redis (Single Instance Only): If REDIS_URL is not provided, the app defaults to in-memory mode. This works fine for testing or single-container deployments but will not sync state correctly if you run multiple replicas.