Installation

bettercap supports GNU/Linux, BSD, Android, Apple macOS, and Microsoft Windows.

You can install the latest stable release or the bleeding edge from the GitHub repository.

Dependencies

You’ll need these dependencies on your system:

• pkg-config
• libpcap
• libusb-1.0-0 (required by the HID module)
• libnetfilter-queue (on Linux only, required by the packet.proxy module)

Using pre-built binaries

Pre-built binaries are available for each new release. Currently available for:

• Darwin arm64
• Linux amd64
• Windows amd64

Using Go

Provided you have Go installed:

go install github.com/bettercap/bettercap/v2@latest

Using Docker

Note

Modules requiring direct hardware access won’t work in Docker. Example: wifi.recon needs hardware access.

bettercap is containerized using Alpine Linux. The resulting Docker image is small and easy to manage.

Requires Docker version > 17.05 (uses multi-stage build).

To pull latest version of the image:

docker pull bettercap/bettercap

To run:

docker run -it --privileged --net=host bettercap/bettercap -h

Using Homebrew

Provided you have Homebrew installed:

brew install bettercap

Compiling from sources

Before compiling, ensure:

• Go >= 1.8 is correctly configured
• $GOPATH is defined and $GOPATH/bin is in $PATH
• For limited hardware (Raspberry Pi Zero), consider increasing swap size

You’ll also need to install the dependencies:

• build-essential
• libpcap-dev
• libusb-1.0-0-dev (required by the HID module)
• libnetfilter-queue-dev (on Linux only, required by the packet.proxy module)

Then compile and install to /usr/local/bin/bettercap:

go get github.com/bettercap/bettercap
cd $GOPATH/src/github.com/bettercap/bettercap
make build
sudo make install

Compiling on Android

Termux Method

Note

This procedure and bettercap itself require a rooted device.

Install Termux and from its prompt type:

pkg install root-repo
pkg install golang git libpcap libusb

There’s a golang bug in Termux about hardcoded paths. Apply this workaround:

sudo su
mount -o rw,remount /
mkdir -p /home/builder/.termux-build/_cache/18-arm-21-v2/bin/
ln -s `which pkg-config` /home/builder/.termux-build/_cache/18-arm-21-v2/bin/arm-linux-androideabi-pkg-config

Linux Deploy Method Debian based (like Ubuntu)

Install Linux Deploy and JuiceSSH. In Linux Deploy, install kalilinux_arm (requires piggy helper). Enable SSH, then type:

sudo apt update
sudo apt install golang git build-essential libpcap-dev libusb-1.0-0-dev libnetfilter-queue-dev

You can now proceed with the compilation:

go get -u github.com/bettercap/bettercap

Once the build process is concluded, the binary will be located in go/bin/bettercap.

Linux Deploy Method Fedora based (like Redhat, Centos)

sudo dnf update
sudo dnf install golang git make automake gcc gcc-c++ kernel-devel libpcap-devel libusb1-devel libnetfilter_queue-devel