alt tag Build Status Known Vulnerabilities Maintainability Linter Analytics


Legion, a fork of SECFORCE's Sparta, is an open source, easy-to-use, super-extensible and semi-automated network penetration testing framework that aids in discovery, reconnaissance and exploitation of information systems. Legion is developed and maintained by GoVanguard. More information about Legion, including the roadmap, can be found on it's project page at If you are interested in contributing to Legion, join our Legion Keybase Team.





It is preferable to use the docker image over a traditional installation. This is because of all the dependancy requirements and the complications that occur in environments which differ from a clean, non-default installation.

NOTE: Docker versions of Legion are unlikely to work when run as root or under a root X!

Supported Distributions

Docker runIt script

runIt supports Ubuntu 18, Fedora 30, Parrot and Kali at this time. It is possible to run the docker image on any Linux distribution, however, different distributions have different hoops to jump through to get a docker app to be able to connect to the X server. Everyone is welcome to try and figure those hoops out and create a PR for runIt.

Traditional Install

We can only promise correct operation on Ubuntu 18 using the traditional installation at this time. While it should work on ParrotOS, Kali and others, until we have Legion packaged and placed into the repos for each of these distros it's musical chairs with regards to platform updates changing and breaking dependencies.


Linux with Local X11:

Linux with Remote X11:

Windows under WSL using Xming and Docker Desktop:

Windows using Xming and Docker Desktop without WSL:

OSX using XQuartz:

Setup Docker on Linux:

Setup Docker to allow non-root users:

Setup Hyper-V, Docker Desktop, Xming and WSL:



Executing test cases

To run all test cases, execute the following in root directory:

python -m unittest


Legion is licensed under the GNU General Public License v3.0. Take a look at the LICENSE for more information.