Skip to content

Latest commit

 

History

History
184 lines (165 loc) · 11.5 KB

README.md

File metadata and controls

184 lines (165 loc) · 11.5 KB
Raw

Exegol

Exegol is a fully configured kali light base with many useful additional tools, resources (scripts and binaries for privesc, credential theft etc.) and some configuration (oh-my-zsh, history, aliases, colourized 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. It is now an environnement my team and I use in day to day engagements.

The biggest 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 ultra-famous tools only. Some tools are pre-configured and/or customized (colored output, custom NtChallengeResponse in Reponder, ...)
  • 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.

Screenshot Empire/DeathStar/mitm6/Responder/ntlmrelayx

⏩ Quick start

🚧 Docker Hub builds are failing right now (see issue #11). For now, ignore this part and refer to installation from GitHub and usage

The project is on Docker Hub, you don't need to clone this git.

⚠️ Don't run the install.sh script on your host. It is meant to run on the docker build.

  1. First set the following aliases in your bashrc/zshrc/whateverrc.
alias exegol-update='docker pull nwodtuhs/exegol'
alias exegol-build='docker build --tag nwodtuhs/exegol /PATH/TO/Exegol/'
alias exegol-run='docker run --interactive --tty --detach --network host --volume /PATH/TO/Exegol/shared-volume:/share --name exegol nwodtuhs/exegol'
alias exegol-shell='docker exec -it exegol zsh'
alias exegol-stop='docker stop exegol && docker rm exegol'
  1. Then pull : docker pull nwodtuhs/exegol
  2. Then run the docker and get a shell : exegol-run && exegol-shell
  3. Stop it when you're done : exegol-stop

📌 Pre-requisites

Docker is needed here if you want to run Exegol in a docker (intended). You can also use the install.sh in order to deploy Exegol elsewhere but I don't guarantee it'll work. (That being said I don't guarantee anything bro)

Need a quick install of docker & docker-compose? Check this out (intended for kali users but I guess it could work on any other Debian based system)

sudo apt-get install apt-transport-https ca-certificates curl gnupg-agent software-properties-common
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
echo 'deb [arch=amd64] https://download.docker.com/linux/debian buster stable' | sudo tee /etc/apt/sources.list.d/docker.list
sudo apt-get update
sudo apt-get install -y docker-ce docker-ce-cli containerd.io
sudo curl -L "https://github.com/docker/compose/releases/download/1.25.3/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose
sudo curl -L https://raw.githubusercontent.com/docker/compose/1.25.3/contrib/completion/bash/docker-compose -o /etc/bash_completion.d/docker-compose
sudo groupadd docker
sudo usermod -aG docker $USER

🐳 Install (from Docker Hub)

🚧 Docker Hub builds are failing right now (see issue #11)

It can be long, pull exegol before needing it.

docker pull nwodtuhs/exegol

:octocat: Install (from GitHub)

The build can be long, build exegol before needing it.

⚠️ Don't run the install.sh script on your host. It is meant to run on the docker build.

git clone https://github.com/ShutdownRepo/Exegol
cd Exegol
docker build --tag exegol .

🔎 Usage

I personnaly use these aliases to go fast (very fast)

alias exegol-update='docker pull nwodtuhs/exegol'
alias exegol-build='docker build --tag nwodtuhs/exegol /PATH/TO/Exegol/'
alias exegol-run='docker run --interactive --tty --detach --network host --volume /PATH/TO/Exegol/shared-volume:/share --name exegol nwodtuhs/exegol'
alias exegol-shell='docker exec -it exegol zsh'
alias exegol-stop='docker stop exegol && docker rm exegol'
  • Update the docker : exegol-update
  • Run the docker : exegol-run
  • Get a shell when exegol is up and running (it is possible to pop multiple shells) : exegol-shell
  • Stop exegol : exegol-stop

🔧 Tools

The tools installed in Exegol are mostly installed from sources in order to have the latest version when deploying Exegol. Some of the tools can be found in a complete kali install though. Some installs are made with go, pip, apt, gem etc. The installs are not perfect but hey, it works! You will find most of the tools in /opt/tools. Some of the 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

Another useful feature is the populated 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.

🚀 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, ...).

📝 To-Do List

Here are some things to add/correct that I have in mind, I'll work on that asap

  • is it possible to use Wifi and Bluetooth??
  • replace impacket install with original repo and manually add commit
  • Issue with dementor and grc, output is not printed unless the process has ended...
  • create a wiki instead of this really long readme?
  • issues when mounting stuff

📢 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)

Introducing Exegol (french)