A script for easily building customized images of pentesting distros (Kali and ParrotSec).
Go to file
Kaj Forney a4cb9fc977 Quality of life update.
Actually error out if no .iso is created, keep build logs in a logs folder, and add a timestamp to the finished files.


Former-commit-id: b4d4430792851f1b591fae451af1139aa83af26c
Former-commit-id: 95f60dc40903d3cccfb755f8cc25f8e5fc629db1
2019-01-25 00:19:04 -07:00
build Add directories. 2018-09-26 17:00:39 -06:00
config Hack to allow VLC to run as root. 2019-01-24 14:33:28 -07:00
debs Update .deb files. 2019-01-24 14:15:17 -07:00
filesystem Edit bash prompt. 2018-11-16 14:57:41 -07:00
images Add directories. 2018-09-26 17:00:39 -06:00
logs Quality of life update. 2019-01-25 00:19:04 -07:00
modules Update parrot-build submodule. 2019-01-23 16:51:33 -07:00
.gitignore Add .gitignore file. 2018-11-16 15:01:00 -07:00
.gitmodules ...adding submodules! 2018-11-07 16:32:09 -07:00
LICENSE Initial commit 2018-09-05 17:05:27 -06:00
README.md Quality of life update. 2019-01-25 00:19:04 -07:00
runme.sh Quality of life update. 2019-01-25 00:19:04 -07:00

README.md

Pentest Distro Builder

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

Running

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 ./runme.sh . 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

Examples

sudo ./runme.sh -u -l Kali -d mate -r 192.168.0.30

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

sudo ./runme.sh -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.