Dramelac / Exegol

Exegol is a fully featured and community-driven hacking environment

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Exegol



DockerHub build type DockerHub build state image size GitHub code size in bytes Python
latest commit on master latest commit on dev



πŸ’‘ TL;DR: Exegol is a community-driven hacking environment, powerful and yet simple enough to be used by anyone in day to day engagements.

Exegol is a fully configured docker with many useful additional tools, resources (scripts and binaries for privesc, credential theft etc.) and some configuration (oh-my-zsh, history, aliases, colorized output for some tools). It can be used in pentest engagements, bugbounty, CTF, HackTheBox, OSCP lab & exam and so on. Exegol's original fate was to be a ready-to-hack docker in case of emergencies during engagements.

The main features of Exegol are:

  • πŸ”§ Tools: many tools that are either installed manually or with apt, pip, go etc. Some of those tools are in kali, some are not. Exegol doesn't come with only ultra-famous tools, you will find ones that the community loves to use, even if it's in dev/new/not famous. Some tools are pre-configured and/or customized (colored output, custom NtChallengeResponse in Responder, custom queries in BloodHound, ...)
  • πŸ’‘ Resources: many resources can be useful during engagements. Those resources are not referred to as "tools" since they need to be run on a pwned target, and not on the attacker machine (e.g. mimikatz, rubeus, ...).
  • πŸ“œ History: a populated history file that allows exegol users to save time and brain space by not having to remember every tool option and argument or checking the "help" every time.
  • πŸš€ Aliases: a file containing aliases that can be handful when using manually installed tools, or doing common operations.
  • πŸ”Ž Usage : a powerful Python3 wrapper used to manage Exegol container and image very easily (handles docker operations like docker pull, docker build, docker run, docker start, docker stop, docker ps, docker rm, docker inspect).

⏩ Quick start

Bear in mind that the install process can be long as it downloads a ~6GB image.

git clone https://github.com/ShutdownRepo/Exegol && cd Exegol
python3 -m pip install -r requirements.txt
python3 exegol.py start

πŸ“₯ Install

The install process takes time. Install it before needing it.

  1. Clone this repo: git clone https://github.com/ShutdownRepo/Exegol
  2. Install the python requirements to use the wrapper: python3 -m pip install -r requirements.txt
  3. (optional) Set the following alias in you zshrc/bashrc/whateverrc: alias exegol='python3 /PATH/TO/Exegol/exegol.py'
  4. Install : exegol install

πŸ”Ž Usage

  1. Start : exegol start
  2. Stop : exegol stop
  3. Reset the container state : exegol reset
  4. Get help on advanced usage : exegol --help

πŸ” Credentials

Some tools are pre-configured with the following credentials

Element User Password
wso-webshell (PHP) exegol4thewin
neo4j database neo4j exegol4thewin
bettercap ui bettercap exegol4thewin

πŸ“Œ Pre-requisites

You need python3, git, docker 🐳, and 15GB of free storage (What did you expect? A fully featured pentesting environment for less than 2GB? If you've got ideas I'm all ears).

πŸ”§ Tools

The tools installed in Exegol are mostly installed from sources in order to have the latest version when deploying Exegol. Some installs are made with go, pip, apt, gem etc. You will find most of the tools in /opt/tools.

πŸ’‘ Resources

In addition to the many tools pre-installed and configured for some, you will find many useful pre-fetched resources like scripts and binaries in /opt/resources. There some pre-EoP enumeration scripts (EoP: Escalation of Privileges) and other useful binaries like Rubeus or mimikatz.

πŸ“œ History

When I hack, I often rely on my history. I don't have to remember command line options, syntax and such. This history is filled with commands that I used in engagements, bugbounties, ctf, oscp and so on. Of course, the values are placeholders that need to be changed with the appropriate ones in your context. The history is easily usable with oh-my-zsh, zsh-autosuggestions, and fzf

πŸš€ Aliases

Since many tools are manually installed in /opt/tools/, aliases could be heplful to use these without having to change directory manually. Other aliases are set to save time while hacking (http-server, php-server, urlencode,ipa, ...).

πŸ“’ Credits & thanks

Credits and thanks go to every infosec addicts that contribute and share but most specifically to @th1b4ud for the base "Kali Linux in 3 seconds with Docker".

πŸŽ₯ Introducing Exegol (in french w/ english subs)

About

Exegol is a fully featured and community-driven hacking environment

License:GNU General Public License v3.0


Languages

Language:Shell 62.5%Language:Python 36.8%Language:Dockerfile 0.7%