GitHub - shell-dot/tuoni: Tuoni
By Taavi Sonets
Archived: 2026-04-10 03:00:21 UTC
 docs sshheellllddoott..ccoomm
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.
Features
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
Screenshots
https://github.com/shell-dot/tuoni
Page 1 of 4

Prerequisites
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
wget or curl must be available
Installation
wget -O - https://tuoni.sh | bash
cd /srv/tuoni
Or with curl:
https://github.com/shell-dot/tuoni
Page 2 of 4

curl https://tuoni.sh | bash
cd /srv/tuoni
Running the installer again will update Tuoni to the latest version. The Tuoni service will restart automatically.
Silent / Automated Install
Set SILENT=1 to run without any prompts — useful for provisioning scripts or CI pipelines:
export SILENT=1
curl https://tuoni.sh | bash
Environment Variables
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 curl
Getting Started
https://github.com/shell-dot/tuoni
Page 3 of 4

After 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 help
Full documentation is at docs.shelldot.com.
Community
Questions, feedback, or want to get involved? Join us on Discord.
Acknowledgements
Tuoni is built on top of a number of excellent open-source projects. See ACKNOWLEDGEMENTS.md for
details.
Source: https://github.com/shell-dot/tuoni
https://github.com/shell-dot/tuoni
Page 4 of 4