Skip to content

og-casque/sadela

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

30 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

sadela

A feature-rich pentesting Docker image based on Debian 12, bundled with a Python CLI wrapper to manage images and containers effortlessly.

The image ships with 100+ pre-installed offensive security tools, wordlists and privilege-escalation resources so you can spin up a ready-to-go pentest environment in seconds.


Table of Contents


Prerequisites

  • Docker (daemon running)

  • Python 3

  • xhost (usually part of xorg or x11-xserver-utils) — required for GUI apps (BloodHound)


Installation

git clone https://github.com/og-casque/sadela.git
cd sadela
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

Quick Start

1. Pull the pre-built image

./sadela.py -p

You can also specify a version: ./sadela.py -p -i v0.3

2. Create and enter a container

./sadela.py -r -n mypentest

With a workspace and shared directory:

./sadela.py -r -n mypentest -w /path/to/project -s /path/to/shared/tools

3. Re-enter an existing (stopped) container

./sadela.py -r -n mypentest

The wrapper detects the container state and starts/attaches automatically.

4. List tracked containers and images

./sadela.py -l

5. Delete a container

./sadela.py -R -n mypentest

6. Build the image locally (optional)

./sadela.py -b          # standard build
./sadela.py -b -d       # debug/verbose build (--no-cache --progress=plain)

CLI Reference

Flag Long Description
-p --pull Pull the image from GHCR (use -i to specify a version)
-b --build Build the Docker image locally
-d --debug Verbose build output (implies --no-cache --progress=plain)
-f --dockerfile Path to Dockerfile (default: BuildDir/Dockerfile.debian)
-r --run Create, start, or resume a container
-n --name Container name (required for -r, -R)
-w --work-dir Host directory mounted at /workspace (read-write)
-s --shared-dir Host directory mounted at /shared (read-only)
-i --image Image tag (e.g. v0.3 or full ghcr.io/… tag)
-l --list List all tracked containers and images
-R --rm Delete a container
-I --rmi Remove an image (requires -i; refuses if containers reference it)

Warnings & Limitations

  • Linux only — tested on X11-based desktop environments. GUI applications (BloodHound) require X11.
  • Wayland is not supported for GUI forwarding; use XWayland or an X11 session.
  • This project is under active development — some edge cases may not be handled. All pre-installed tools should work out of the box.

About

Pentesting docker image with a wrapper to make it cool.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors