Skip to content

Jouleworks/rosterboard

Repository files navigation

basic example rosterboard logo

rosterboard

A management board and system for mobile teams.

Features

  • Fully web-based, no operating system requirements
  • WYSIWYG-style Drag-and-drop Team Management for Ease of Use
  • Bulk Actions Editor (Pressing ESC or Tilde)
  • Uses modern HTML and Services
  • Multiple people can view and edit the same board (Multiplayer via Websockets, no additional server needed)
  • Built-in Timekeeping between on and off shift users
  • "High Volume" mode to group members together into fireteams
  • Highlight specific high-value roles in the sidebar to keep track of VIPs
  • Kiosk URLs and free-badge association to allow users to manage their own status (With permissive restrictions if necessary)
  • Role,Rank,Duty categorizations to allow admins and managers to see at-a-glance what qualifications a member has
  • Notes field for bespoke notes per-user
  • Multi-tenant, to allow one application to manage multiple events.

Demo

https://rosterboard.jouleworks.net

Requirements

  • Docker (If using Docker Setup)
  • Python 3.12.x
  • PostgreSQL 16 or newer
  • Redis 7 or newer

Getting Started

Using Docker

docker volume create rosterboard-data
docker run -v rosterboard-data:/app/config -p 8080:8080 --restart=unless-stopped --name rosterboard -d jouleworks/rosterboard:v1.0

Using Docker Compose

curl -O https://raw.githubusercontent.com/Jouleworks/rosterboard/refs/heads/main/docker/production/docker-compose.yaml
curl -O .env https://raw.githubusercontent.com/Jouleworks/rosterboard/refs/heads/main/docker/production/.env.example # optional!
docker compose up -d 

From Source

git clone [email protected]:Jouleworks/rosterboard.git
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
bash entrypoint.sh

Go to http://localhost:8080/setup/ to begin.

Upgrading

Using Docker

docker stop rosterboard
docker pull jouleworks/rosterboard:v1.0 # Replace v1.0 with the tag you want to upgrade to here. https://hub.docker.com/r/jouleworks/rosterboard/tags
docker start rosterboard

Using Docker Compose

docker compose up -d

From Source

git pull origin main
bash entrypoint.sh