Skip to content

WifiForge is a tool developed by Black Hills InfoSec to help train Pentesters on different Wi-Fi attack vectors and Wireless capabilities.

License

Notifications You must be signed in to change notification settings

blackhillsinfosec/Wifi-Forge

Wifi Forge Logo

GitHub Workflow Status   Discord   npm   BHIS Twitter   Wifi Forge Stars



Wifi Forge

Wifi Forge provides a safe and legal environment for learning WiFi hacking. Based on the open source Mininet-Wifi, this project automatically sets up the networks and tools needed to run a variety of WiFi exploitation labs, removing the need for the overhead and hardware normally required to perform these attacks.

Disclaimer/Notes

  • The installation script will only run on Ubuntu, Parrot, or Kali.
  • It is suggested to run Wifi Forge on Ubuntu version 24.04 or the lastest version of Kali.
  • The Wifi Forge installation script may disrupt normal operating system use, it is suggested to use a fresh install, virtual machine, or build using the provided dockerfile (see Set-Up Guide/Docker)

Compatibility

Wifi-Forge should work on any linux operating system using the docker image. The following Operating Systems have been tested and are confirmed to work.

  • Kali Linux
  • Parrot OS
  • Ubuntu

Installation

Installation Documentation

Walkthroughs

Walkthroughs

Common Issues

Xterm does not work!

Intializing graphical interfaces as root between the docker image and host machine is restricted on most modern distributions. Run the following command to provide the appropriate permissions -

xhost si:localuser:root

If other issues are encountered, start a thread in the issues section of the repo.

Dockerfile stops at apt update!

Once in a while, the dockerfile will fail before installing packages. Though unconfirmed, this error usually occurs after running Wifi-forge (either on baremetal or within a docker). Rebooting and running the Dockerfile again typically solves the issue.

Links and Further Reading

Brought to you by Black Hills Infosec