kforney/pentest-distro-builder
1
0
Fork 0
mirror of https://github.com/kforney/pentest-distro-builder.git synced 2024-05-09 03:03:35 -06:00
Code Issues Packages Projects Releases Wiki Activity
A script for easily building customized images of pentesting distros (Kali and ParrotSec).
57 commits 3 branches 0 tags 428 MiB
Shell 89.8%
Scheme 9.4%
Assembly 0.4%
Go to file
Kaj Forney c9435ed3b0 Revert "Testing Aptly stuff..." 
This reverts commit 270ac0721a301991110449c56568b82c2c35df0f [formerly df2f046f30ca87e758e1cdf2466f822260bf95d3] [formerly 2a2819201a8b70c7dcd338d9449b73acad4ecb2c].


Former-commit-id: e2f96d43c0e59458375311295ebc6d3e75c536fd
Former-commit-id: 45a997e45c5fe8aa4c91e33647284bd396f2bfa1
2018-10-31 13:55:10 -06:00
build Add directories. 2018-09-26 17:00:39 -06:00
config kill the bug with fire. 2018-10-23 17:21:53 -06:00
debs Temporarily add btrfs-tools here to fix Parrot. 2018-10-31 13:53:53 -06:00
filesystem Skel changes. 2018-10-23 14:41:03 -06:00
images Add directories. 2018-09-26 17:00:39 -06:00
modules Revert "Testing Aptly stuff..." 2018-10-31 13:55:10 -06:00
LICENSE Initial commit 2018-09-05 17:05:27 -06:00
README.md Move hook to config folder. 2018-10-18 18:01:16 -06:00
runme.sh Repository changes. 2018-10-23 15:07:19 -06: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

Just clone the repository, 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.

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

  • -u
    • Unattended mode (skip the menu, required for the other options to function)
  • -l
    • Linux distribution you wish to build (can be either "Kali" or "Parrot")
  • -d
    • Desktop environment (can be one of "cinnamon", "gnome", "kde", "lxde", "mate", or "xfce")
  • -r (optional)
    • Repository (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.