Installation

bettercap supports GNU/Linux, BSD, Android, Apple macOS and the Microsoft Windows operating systems - depending if you want to install the latest stable release or the bleeding edge from the GitHub repository, you have several choices.

Dependencies

In order to be able to use bettercap, you’ll need the following 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)

Installing via Go

Provided you have Go installed:

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

Using Docker

bettercap is containerized using Alpine Linux - a security-oriented, lightweight Linux distribution based on musl libc and busybox. The resulting Docker image is relatively small and easy to manage the dependencies. Since it is using a multi-stage build, a Docker version greater than 17.05 is required.

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

In order to compile bettercap from sources, make sure that:

• You have a correctly configured Go >= 1.8 environment.
• $GOPATH is defined and $GOPATH/bin is in $PATH.
• For hardware with limited resources (like Raspberry Pi Zero boards) you might want to increase the 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)

Once you’ve met this conditions, you can run the following commands to compile and install bettercap in /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 some hardcoded path, the fix is ugly but it works:

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, JuiceSSH, in Linux Deploy install kalilinux_arm (u need the piggy helper and enable the SSH) and 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