Skip to main content


Learn how to run Evilginx in your local environment in development mode.


Launch Evilginx in development environment with the following command (-P is optional for Evilpuppet owners).

If you built Evilginx yourself from source code and you are in root directory of the repository:

sudo ./build/evilginx -p ./phishlets -t ./redirectors -P -developer

If you have Evilginx release package:

sudo ./evilginx -P -developer

In order to be able to locally open your phishing links, in a web browser, using a TLS connection signed by a self-signed TLS certificate, generated by Evilginx, you will need to add Evilginx Root CA certificate into your trusted root certificates storage.

The generated root CA certificate can be found at /root/.evilginx/crt/ca.crt. Make sure to run Evilginx at least once to generate the certificate file.

sudo cp /root/.evilginx/crt/ca.crt /usr/local/share/ca-certificates/evilginx.crt
sudo update-ca-certificates



This part applies only to Evilginx Pro users who have access to Evilpuppet module.

Make sure you are using a non-root user.

First prepare the environment:

sudo apt-get update
sudo apt-get -y install xorg xvfb tmux curl

curl -sL | sudo bash -
sudo apt-get -y install nodejs

sudo apt-get -y install ca-certificates fonts-liberation libappindicator3-1 libasound2 libatk-bridge2.0-0 libatk1.0-0 libc6 libcairo2 libcups2 libdbus-1-3 libexpat1 libfontconfig1 libgbm1 libgcc1 libglib2.0-0 libgtk-3-0 libnspr4 libnss3 libpango-1.0-0 libpangocairo-1.0-0 libstdc++6 libx11-6 libx11-xcb1 libxcb1 libxcomposite1 libxcursor1 libxdamage1 libxext6 libxfixes3 libxi6 libxrandr2 libxrender1 libxss1 libxtst6 lsb-release wget xdg-utils
sudo sysctl -w kernel.unprivileged_userns_clone=1

Go to evilpuppet directory and install all npm dependencies.

cd evilpuppet
npm install

Make sure you are running X Window System. The background browser needs a GUI environment to render to. If you are using a terminal with no GUI on your system, you can spawn X in the background, using these commands:

Xvfb -ac :99 -screen 0 1280x1024x16 &>/dev/null & disown
export DISPLAY=:99

Run Evilpuppet:

npm start