Git Product home page Git Product logo

exegol's Introduction

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)

exegol's People

Contributors

cse-ocd avatar dramelac avatar driikolu avatar fisjkars avatar mayfly277 avatar shutdownrepo avatar snovvcrash avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.