You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Kaj Forney 4e36f6e507
Add sleep statement to pingsweep.
1 month ago
build Add directories. 2 years ago
config Add conversion script for vanilla Kali. 1 month ago
debs Minor conversion script bugfix. 1 month ago
filesystem Add sleep statement to pingsweep. 1 month ago
images Add directories. 2 years ago
logs Quality of life update. 2 years ago
modules We want to build on Debian too... 11 months ago
.gitignore Add .gitignore file. 2 years ago
LICENSE Initial commit 2 years ago Update '' 1 month ago Minor conversion script bugfix. 1 month ago Revert change made while running on 2 hours of sleep. 1 month ago

Pentest Distro Builder

This script automates the process of building the most common pentesting Linux distributions, Kali Linux and Parrot Security OS.


Clone this repository with git clone --recursive, then make whatever changes you wish to make.

  • Add any .deb files to the debs/ folder that you want installed into the image.
  • Add any files to the filesystem/ folder that you want on the final system.
  • Add any extra software from the repository you wish to install to the config/software.list.chroot file.
  • Add any commands you want to have run during the build process to the config/pentest-distro-builder.chroot file.

When you’re ready to build, run sudo ./ . Once it’s complete, the finished image will be copied to the images/ folder, and a log file will be created in the logs/ folder.

If you run the script without any options, it will build whichever OS you are currently running, and prompt for which desktop environment and repository you wish to use. If you wish, however, you can manually specify these options instead (for example, to script an image to be built nightly or weekly):

Flag Option Description
-u Unattended mode Skip the menu (required for the other options to function)
-l Distribution Can be either “Kali” or “Parrot”
-d Desktop environment Can be one of “cinnamon”, “gnome”, “kde”, “lxde”, “mate”, or “xfce”
-r Repository (optional) Can be either “default” for the distribution’s default repo, or an IP address


sudo ./ -u -l Kali -d mate -r

This will build a Kali Linux .iso, with the MATE desktop environment, using a local repository at

sudo ./ -u -l Parrot -d cinnamon

This will build a Parrot Security OS .iso, with the Cinnamon desktop environment, using the default Parrot repository.

If -r is unspecified, then the default will be used.

Converting a Vanilla Kali Installation

If you already have a copy of Kali installed, and just want to add our changes on top of it, simply run the “” script. It will apply the modifications this script would have built into the image automatically. You do not have to be root to run the script; it will prompt for sudo as needed.