Skip to documentation content

Documentation

Running an exercise

Path: Exercises (/exercises)

An exercise is a live session instance from a scenario template.

Prerequisites

  1. At least one scenario template
  2. Participant roles defined (Settings → Participants & Roles)
  3. Room under completed-exercise cap if applicable

Completed exercise limits: Starter 3 · Plus 10 · Pro 20

Step 1: Create exercise

  1. Scenarios → Run on a template, or Exercises → New exercise
  2. Choose template (tabs: Your scenarios / CTEP / Breachday; search and filter by focus)
  3. Set room password (8–128 characters) and confirm
  4. Plus/Pro: optionally check Remove this exercise from Breachday after the run (auto-deletes session data after org retention window; template stays) Plus Pro
  5. Click Start exercise → session created in Lobby/exercises/[id]
Exercise lobby page showing the room code and room password, Open lobby toggle, scenario overview, Participants & roles panel, and Start exercise button.
The exercise lobby: share the room code and password, open the lobby, then Start exercise.

Step 2: Prepare lobby (facilitator)

ActionDetails
Open lobbyOff by default. Turn on so participants can join
Copy join link/join/{roomCode} — share with participants
Copy passwordShare separately from link
Manage participants & rolesRemove participants/roles; add org roles not yet in session
Delete exerciseOnly while in Lobby (does not delete scenario template)

Step 3: Start live exercise

Click Start exercise → status Live (ACTIVE) → facilitator routed to facilitation view.

Exercise lifecycle

Exercise status flow
  LOBBY ──Start──▶ ACTIVE ◀──▶ PAUSED
                      │
                  Complete
                      │
                      ▼
                  COMPLETED
StatusUI labelMeaning
LOBBYLobbyWaiting room; participants can join if lobby is open
ACTIVELiveExercise running
PAUSEDPausedTimer frozen; participants wait
COMPLETEDEndedExercise finished; report available

There is no "draft" or "scheduled" exercise state — create the session when ready to run.

After the exercise ends, the exercise page shows View report & wrap-up — see Reports & hotwash.

Deleting exercises

  • Lobby: Deletes session only; template kept
  • Completed: Deletes session and report together