🐧Installation for Unix

Installing NetExec with pipx 🎷

We do recomand to install rust before to make sure everything will work properly

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Also, on some distributions, python headers may not be installed with python but are needed for arc4 dependency build. To install them if you encounter arc4.c:2:10: fatal error: Python.h: No such file or directory error.

Using pipxto install NetExec is recommended. This allows you to use NetExec and the nxcdb system-wide.

sudo apt install pipx git
pipx ensurepath
pipx install git+https://github.com/Pennyw0rth/NetExec

Open a new shell and you are ready to go:

NetExec
nxcdb

Updating via pipx:

pipx upgrade netexec        # Will update if there is a new version
pipx reinstall netexec      # Force download the latest commits from github

Failed building wheel for aardwolf

If pip fails to build aardwolf you need to install rust. Don't forget to reload your shell so rust is added to your PATH!

Installation for Kali 🐲

apt update
apt install netexec

Installation for BlackArch 🗡️

pacman -Syu netexec

Installation for ParrotSec 🦜

apt update
apt install netexec

Availability on other Unix distributions 🐧

Installation for development using UV

Install uv (and rust)

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
apt install pipx git
pipx ensurepath
pipx install uv

Now that UV is set, up and we can download the NetExec repository and install its dependencies:

git clone https://github.com/Pennyw0rth/NetExec
cd NetExec
uv tool install .
uv run netexec

Installation for development using Poetry 📯

We do not recommand to install poetry via APT on kali

You're going to need to install Poetry which is what nxc uses to manage dependencies. To install poetry you should use pipx, because our dynamic-versioning plugin will likely crash otherwise.

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
apt install pipx git
pipx ensurepath
pipx install poetry
poetry self add "poetry-dynamic-versioning[plugin]"
poetry dynamic-versioning enable

Now that poetry is set, up and we can download the NetExec repository and install its dependencies:

git clone https://github.com/Pennyw0rth/NetExec
cd NetExec
poetry install
poetry run NetExec

Binaries

We recommend installing via pipx/pip, but if you want to use a pre-compiled binary, go to the Releases and download the appropriate binary.