7.5k GitHub stars and counting — apache/caldera is a Python project TopGit is tracking across repositories on the platform. Automated Adversary Emulation Platform
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
Caldera™ is a cyber security platform designed to easily automate adversary emulation, assist manual red-teams, and automate incident response.
It is built on the MITRE ATT&CK™ framework and is an active research project at MITRE.
The framework consists of two components:
The core system. This is the framework code, consisting of what is available in this repository. Included is
an asynchronous command-and-control (C2) server with a REST API and a web interface.
Plugins. These repositories expand the core framework capabilities and providing additional functionality. Examples include agents, reporting, collections of TTPs and more.
Resources & Socials
📜 Documentation, training, and use-cases
🎬 Tutorial Videos
✍️ Caldera's blog
🌐 Homepage
Plugins
:star: Create your own plugin! Plugin generator: Skeleton :star:
Default
These plugins are supported and maintained by the Caldera team.
Access (red team initial access tools and techniques)
Atomic (Atomic Red Team project TTPs)
Builder (dynamically compile payloads)
Caldera for OT (ICS/OT capabilities for Caldera)
Compass (ATT&CK visualizations)
Debrief (operations insights)
Emu (CTID emulation plans)
Fieldmanual (documentation)
GameBoard (visualize joint red and blue operations)
Human (create simulated noise on an endpoint)
Magma (VueJS UI for Caldera v5)
Manx (shell functionality and reverse shell payloads)
Response (incident response)
Sandcat (default agent)
SSL (enable https for caldera)
Stockpile (technique and profile storehouse)
Training (certification and training course)
More
These plugins are ready to use but are not included by default and are not maintained by the Caldera team.
Arsenal (MITRE ATLAS techniques and profiles)
BountyHunter (The Bounty Hunter)
CalTack (embedded ATT&CK website)
SAML (SAML authentication)
Requirements
These requirements are for the computer running the core framework:
Any Linux or MacOS
Python 3.10+ (with Pip3)
Recommended hardware to run on is 8GB+ RAM and 2+ CPUs
Recommended: GoLang 1.24+ to dynamically compile GoLang-based agents.
NodeJS (v16+ recommended for v5 VueJS UI)
Installation
Note: we HIGHLY recommend installing Caldera in a Python virtual environment to avoid issues with pip packages. You can use an existing environment if you wish or create a new one from scratch:
Full steps:
Start by cloning this repository recursively, passing the desired version/release in x.x.x format. This will pull in all available plugins.
The --build flag automatically installs any VueJS UI dependencies, bundles the UI into a dist directory and is served by the Caldera server. You will only have to use the --build flag again if you add any plugins or make any changes to the UI. Once started, log into http://localhost:8888 using the default credentials red/admin. Then go into Plugins -> Training and complete the capture-the-flag style training course to learn how to use Caldera.
If you prefer to not use the new VueJS UI, revert to Caldera v4.2.0. Correspondingly, do not use the --build flag for earlier versions as not required.
Additionally, please note security recommendations for deploying Caldera.
Docker Installation
Local build:
git clone https://github.com/apache/caldera.git --recursive
cd caldera
docker build --build-arg VARIANT=full -t caldera .
docker run -it -p 8888:8888 caldera
Adjust the port forwarding (-p) and build args (--build-arg) as desired to make ports accessible or change the Caldera variant. The ports that you expose depend on which contacts you plan on using (see Dockerfile and docker-compose.yml for reference).
Pre-Built Image (from GitHub Container Registry):
docker run -p 8888:8888 ghcr.io/apache/caldera:latest
This container may be slightly outdated, we recommend building the container yourself.
To gracefully terminate your docker container, do the following:
# Find the container ID for your docker container running Caldera
docker ps
# Stop the container
docker stop <container ID>
There are two variants available, full and slim. The slim variant doesn't include files necessary for the emu and atomic plugins, which will be downloaded on-demand if the plugins are ever enabled. The full variant is suitable for operation in environments without an internet connection. Slim images on GHCR are prefixed with "slim".
Docker Container Notes
The Caldera container will automatically generate keys/usernames/password on first start.
If you wish to override the default configuration or avoid automatically generated keys/passwords, consider bind-mounting your own configuration file with the -v <your_path>/conf.yml:/usr/src/app/conf/local.yml flag.
Data stored by Caldera is ephemeral by default. If you wish to make it persistent, use docker volumes and/or bind mounts (-v <path_to_your_data_or_volume_name>:/usr/src/app/data/). Ensure that the directory structure is the same as in the data/ directory on GitHub, as Caldera will refuse to create these sub-directories if they are missing. Lastly, make sure that the configuration file is also made persistent to prevent issues with encryption keys.
The builder plugin will not work within Docker.
If you wish to modify data used by the atomic plugin, clone the Atomic Red Team repository outside the container, apply your modifications and bind-mount it (-v) to /usr/src/app/plugins/atomic/data/atomic-red-team within the container.
If you wish to modify data used by emu, clone the adversary_emulation_library repository locally and bind-mount it (-v) to /usr/src/app/plugins/emu/data/adversary-emulation-plans.
Additionally, please note security recommendations for deploying Caldera.
User Interface Development
If you'll be developing the UI, there are a few more additional installation steps.
Requirements
NodeJS (v16+ recommended)
Setup
Add the Magma submodule if you haven't already: git submodule add https://github.com/mitre/magma
Install NodeJS dependencies: cd plugins/magma && npm install && cd ..
Start the Caldera server with an additional flag: python3 server.py --uidev localhost
Your Caldera server is available at http://localhost:8888 as usual, but there will now be a hot-reloading development server for the VueJS front-end available at http://localhost:3000. Both logs from the server and the front-end will display in the terminal you launched the server from.
Security
The Caldera team highly reccommends standing up the Caldera server on a secure environment/network, and not exposing it to the internet. The Caldera server does not have a hardened and thoroughly pentested web application interface, but only basic authentication and security features. Both MITRE and MITRE's US Government sponsors nearly exclusively only use Caldera on secure environments and do not rely on Caldera's own security protocols for proper cyber security.
Vulnerability Disclosures
Refer to our Vulnerability Disclosure Documentation for submitting bugs.
Recent Vulnerability Disclosures
🚨Security Notice🚨: (17 Feb 2025 10:00 EST) Please pull v5.1.0+ for a recent security patch for CVE-2025-27364. Please update your Caldera instance, especially if you host Caldera on a publicly accessible network. Vulnerability walkthrough.
Contributing
Refer to our contributor documentation.
Caldera Benefactor Program
If you are interested in partnering to support, sustain, and evolve MITRE Caldera™'s open source capabilities, please contact us at [email protected].
The most recent commit recorded on apache/caldera was 3 months ago, based on the GitHub push timestamp. The repository has 1.4k forks — one of the better signals of community interest.
How many stars does apache/caldera have?
apache/caldera has 7.5k GitHub stars — refresh the page for the live number, or check github.com/apache/caldera. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
Is apache/caldera open source?
Yes — apache/caldera ships under the Apache-2.0 license, which makes its source code freely readable (and, depending on license terms, forkable and reusable). Source: github.com/apache/caldera.
What else is in the Security space?
apache/caldera is tracked by TopGit under the Security category, alongside 7 GitHub-tagged topics. Trending and Topics pages list peer repositories of comparable stars and language.
What is apache/caldera?
apache/caldera (apache/caldera) is a Python project on GitHub. From the project's own README: Automated Adversary Emulation Platform
What language is apache/caldera written in?
apache/caldera is written primarily in Python. GitHub's language field is based on the largest share of bytes in the default branch.
What license does apache/caldera use?
apache/caldera is released under the Apache-2.0 license. Always verify the LICENSE file directly on GitHub for the authoritative terms — license strings can be edited out of sync with a project's actual stance.
Where do I read more about apache/caldera?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/apache/caldera is the definitive source.
Read full README in the tab above.
Still deciding about caldera?
One click hands the question to an AI along with this page — see what it says about caldera.