casebench-ee

Casebench's team server: the workbench with sign-in, five roles, an audit log and admin pages (decision 0058).

Licensed under the Elastic License 2.0. Everything outside ee/ is Apache-2.0.

Run it

Install it from PyPI, with the casebench release of the same version, and start it in a folder holding your runs, suites and casebench.yaml:

pip install casebench-ee
CASEBENCH_DATABASE_URL=postgresql://casebench:secret@db.internal/casebench \
CASEBENCH_PUBLIC_URL=https://casebench.firm.example \
casebench-team serve --host 0.0.0.0

Without CASEBENCH_DATABASE_URL it keeps the team in .casebench/team.db, SQLite, which is enough for a trial.

Or build the container image from the repository's root, and run it with Postgres and a folder holding your runs, suites and casebench.yaml:

docker build -f ee/Dockerfile -t casebench-team .
docker run -p 8080:8080 \
  -e CASEBENCH_DATABASE_URL=postgresql://casebench:secret@db.internal/casebench \
  -e CASEBENCH_PUBLIC_URL=https://casebench.firm.example \
  -v /srv/casebench:/data \
  casebench-team

The first start prints a one-time setup code to the log. Open the public URL, enter the code, and create the first admin with a password of 12 characters or more that is no default.

Settings

Register the Google or Microsoft client with <public URL>/auth/google/callback or <public URL>/auth/microsoft/callback as its redirect address.

Erasing a team

casebench-team erase --database URL --runs-dir DIR --suites DIR --confirm NAME removes every table in the team's database, with the audit log, and everything in its run and suite folders. NAME is the database's name, typed back. What is erased cannot be restored.

From an engineer's machine

Create an API key with the engineer role on the Team page, set it as CASEBENCH_CLOUD_KEY on the engineer's machine, and name the server in casebench.yaml under cloud: url:. Then casebench push, casebench invite and casebench pull work against it (decision 0059).

Develop

uv sync installs casebench-ee with the core. npm run build:team in workbench/ builds the team's web app into ee/casebench_ee/static/. uv run pytest ee/team_tests runs its tests; set CASEBENCH_TEST_POSTGRES to a Postgres server's URL to run the Postgres ones too.