Tuoni is a cross-platform red teaming framework built for cyber defense exercises and security training. It provides a browser-based interface, a modular plugin system, and streamlined reporting — deployed through Docker in minutes.
- Browser-based UI — Operate from any machine, no client installation required
- Modular plugins — Extend and tailor capabilities to fit specific exercise needs
- Docker-native — Consistent, reproducible deployment on Debian, Ubuntu, and Kali Linux
- Built for scale — Designed for large-scale exercises with multiple concurrent operators
- Offline-capable — Optional bundled documentation service for air-gapped environments
- OS: Debian, Ubuntu, or Kali Linux
- Architecture: x86_64 or ARM64
- Docker: 25.0.0 or later — installed automatically if missing
- Network: Outbound internet access for the initial image pull
wgetorcurlmust be available
wget -O - https://tuoni.sh | bash
cd /srv/tuoniOr with curl:
curl https://tuoni.sh | bash
cd /srv/tuoniRunning the installer again will update Tuoni to the latest version. The Tuoni service will restart automatically.
Set SILENT=1 to run without any prompts — useful for provisioning scripts or CI pipelines:
export SILENT=1
curl https://tuoni.sh | bash| Variable | Default | Description |
|---|---|---|
SILENT |
(unset) | Set to 1 to skip all interactive prompts |
NO_UPDATE |
(unset) | Set to 1 to skip updating the app on re-run |
TUONI_USERNAME |
tuoni |
Initial admin username |
TUONI_PASSWORD |
(autogenerated) | Initial admin password |
TUONI_DOCKER_IPV6_ENABLED |
false |
Enable IPv6 on the Docker network |
TUONI_REPO ⚗️ |
https://github.com/shell-dot/tuoni.git |
Source repository override |
TUONI_BRANCH ⚗️ |
main |
Branch to install from |
TUONI_VERSION ⚗️ |
(unset) | Pin a specific version |
TUONI_SUDO_COMMAND ⚗️ |
sudo -E |
Override the sudo invocation |
⚗️ Experimental — intended for development and testing only.
If wget or curl are not installed, add them first:
sudo apt-get install -y wget curlAfter installation, open the URL printed by the installer in your browser and log in with the credentials shown during setup.
The tuoni CLI manages the running services:
tuoni helpFull documentation is at docs.shelldot.com.
Questions, feedback, or want to get involved? Join us on Discord.
Tuoni is built on top of a number of excellent open-source projects. See ACKNOWLEDGEMENTS.md for details.