---

hide:

- navigation
- toc

---

<img class="main-logo" alt="" src="images/inject-logo--horizontal-yellow.svg"> 
# INJECT Exercise Platform Documentation

<div class="bigger-font-size" markdown>
Welcome! Whether you're responsible for technical deployment or facilitating tabletop exercises,
this documentation will equip you with the tools and knowledge needed for successful implementation.
</div>

## What is the INJECT Exercise Platform (IXP)?

- An open-source digital platform designed for conducting interactive tabletop exercises.
- Provides immediate reactions to decisions, enhancing the learning process.
- Simplifies the preparation, execution, and evaluation of exercises, reducing organizer workload.

## Quick Navigation

<div class="main-gridc" markdown>
<div class="navigation-main" markdown>
  [Installation](tech/installation/overview.md){ .md-button }
</div>
<div class="navigation-main" markdown>
  [Exercise Preparation](INJECT_process/intro/overview.md){ .md-button }
</div>
<div class="navigation-main" markdown>
  [Platform Content](INJECT_process/available-definitions.md){ .md-button }
</div>
<div class="navigation-main" markdown style="grid-column-start: 2;">
  [Report issues](report-issue.md){ .md-button }
</div>
</div>

!!! News

    *November 18*, 2025 <br>
    Frontend version 4.0.1 is now available with UI improvements and bug fixes.
    [Changelog](changelog.md#401-frontend)

    *October 20*, 2025 <br>
    Backend version 4.0.2 is now available with fixes to exercise deletion and exercise log export.
    [Changelog](changelog.md#402-backend)

    *September 24*, 2025 <br>
    Backend version 4.0.1 is now available with improved database connection handling,
    a new environment variable and reduced log spam. [Changelog](changelog.md#401-backend)

    *September 10*, 2025 <br>
    We've just released the fourth version of the INJECT Exercise Platform (v4.0.0)– [Changelog](changelog.md#400).
    The entire documentation has been updated to reflect this new version.
    If you are using an older version of the platform, please check our
    [Version Compatibility](tech/version-compatibility.md) page.

    *June 4, 2025* <br>
    Frontend version 3.0.3 is now available with WebSocket connection notifications and improved user experience
    when connection issues occur.
    [Changelog](changelog.md#303-frontend).

    *April 28, 2025* <br>
    Frontend version 3.0.2 has been released, fixing email communication between
    teams and increasing the maximum number of teams per exercise to 50.
    [Changelog](changelog.md#302-frontend).

    *March 28, 2025* <br>
    Frontend version 3.0.1 is out, addressing table selection issues, exercise log
    downloads, and file viewer messaging. [Changelog](changelog.md#301-frontend).

    *February 16, 2025* <br>
    We've just released the third version of the INJECT Exercise Platform (v
    3.0.0)– [Changelog](changelog.md#300).
    The entire documentation has been updated to reflect this new version.
    If you are using an older version of the platform, please check our
    [Version Compatibility](tech/version-compatibility.md) page.

## The Big Picture

<div class="main_grid-border" markdown>

<div class="main_grid-cads" markdown>
<div class="grid cards" markdown>

- ### Technical Documentation

    ______________________________________________________________________

    **The technical documentation provides insight into the platform’s architecture, APIs, security
    features, and installation process.**

    <br>

    **[Installation Guide ↲](tech/installation/overview.md)**: Step-by-step instructions for deploying
    IXP using Docker Compose and Nginx.

    **[Architecture Overview](tech/architecture/overview.md)**: Detailed documentation on the
    architecture of the IXP, including component definition.

    **[Definition Description](tech/architecture/definitions/README.md)**: documentation of exercise
    definitions - learn how YAML-based configurations describe the structure and content of
    exercises.

    **[Version Compatibility](tech/version-compatibility.md)**: Overview of platform versions and
    their corresponding documentation versions - check which documentation version matches your
    platform version.

    **[Security](tech/security.md)**: Details on the security measures and practices implemented in
    the IXP.

    **[API Documentation](tech/api/overview.md)**: Comprehensive documentation of the APIs provided by
    IXP, including RESTful APIs.

- ### Exercise Preparation Guide

    ______________________________________________________________________

    **The INJECT Process provides a clear guide on how to plan, run, and evaluate tabletop exercises
    using the IXP platform.**

    <br>

    **[Start Here ↲](INJECT_process/intro/overview.md):** If you are new to IXP, this is the best
    place to begin.

    **[01 Understanding Phase](INJECT_process/understand/overview.md):** Gather the key information
    about the exercise’s goals, scope, and resources.

    **[02 Specification Phase](INJECT_process/specify/overview.md):** Specify the exercise learning
    objectives, activities and scenario.

    **[03 Preparation Phase](INJECT_process/prepare/overview.md):** Get IXP content, logistics, and
    resources ready for the exercise.

    **[04 Execution Phase](INJECT_process/execute/overview.md):** Run the exercise and manage all
    activities.

    **[05 Reflection Phase](INJECT_process/reflect/overview.md):** Review the exercise and identify
    improvements.

- ### Additional Resources

    ______________________________________________________________________

    **[Glossary of Terms](glossary-of-terms.md)**: Definitions of key terms and concepts used in the
    IXP. <br>
    **[Report Issue](report-issue.md)**: Instructions for reporting bugs, issues, or providing
    feedback on the IXP. <br>
    **[Known Issues](known-issues.md)**: A list of known issues and how to fix them. <br>
    **[Acknowledgements](acknowledgements.md)**: Recognition of individuals or organizations that
    have contributed to the development or support of the IXP. <br>
    **[Authors](authors.md)**: Meet the team behind the development of IXP. <br>

- ### Get in Touch

    ______________________________________________________________________

    We believe that collaboration helps us learn from one another. If you have questions about IXP or
    would like to discuss potential collaborations, please feel free to reach out through our
    website.

    <br>

    <div class="navigation" markdown>
    [INJECT Website](https://inject.muni.cz){ .md-button }
    </div>

</div>
</div>
</div>
