selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

bettercap logo

Self-host bettercap

v2.41.7

Network recon and MITM toolkit for WiFi, BLE, HID, CAN-bus

ReleaseOpen SourceOther
docker run -it --privileged --net=host bettercap/bettercap -h
Updated5 months ago
LanguageGo
Setup difficultyModerate
Stars
20 299
Ports
8080 (Web UI server (ui.port)), 8081 (REST API server (api.rest.port))
Docker
bettercap/bettercap
Web UI events panel listing network events captured during a session

What is bettercap?

bettercap is a Go-based, extensible toolkit that unifies reconnaissance and offensive testing across many network types: 802.11 Wi-Fi, Bluetooth Low Energy gadgets, 2.4 GHz HID peripherals, automotive CAN buses and IPv4/IPv6 segments. It serves security research, red teaming and reverse-engineering work from one interactive command line. Its modules can deauthenticate Wi-Fi clients, capture WPA/WPA2/WPA3 handshakes and run the clientless PMKID attack; enumerate, read and write BLE characteristics; fly HID keystrokes over the air using DuckyScript; decode, inject and fuzz CAN frames from DBC definitions; and perform man-in-the-middle work by probing hosts and spoofing ARP, DNS, NDP or DHCPv6. Traffic can be intercepted through packet, TCP and HTTP/HTTPS proxies scripted in JavaScript, a sniffer harvests credentials (and can fuzz protocols), and a fast port scanner is built in. Drive it from the terminal or caplet scripts, or enable the REST API on port 8081 and the browser UI on port 8080. Pre-built binaries, Homebrew, go install and an Alpine-based Docker image cover Linux, macOS, Windows, BSD and Android, though hardware-hungry modules such as wifi.recon do not work in containers. The Ruby 1.x series is deprecated and archived.

bettercap alternatives

Should you self-host bettercap?

bettercap scores 76/100 on selfhost.directory (how scoring works) and ranks #1 of 15 in Network Security. It has 20 299 GitHub stars, +159 in the last 30 days.

It shipped 2 stable releases in the past year. The latest, v2.41.7, came out on 11 May 2026. New versions land roughly every 5 months.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is Other-licensed and written mostly in Go.

Its closest alternative on selfhost.directory is opnsense (72/100, 4 803 stars). bettercap scores higher overall. See bettercap vs opnsense side by side.

bettercap README

Join the project community on our server!


BetterCap

Release Software License Tests on Linux Tests on macOS Tests on Windows Docker Hub This project is 100% made by humans.

How to install bettercap

Install bettercap with Docker

docker pull bettercap/bettercap

To run:

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

Modules requiring direct hardware access won't work in Docker (e.g. wifi.recon). Image is Alpine Linux based; requires Docker > 17.05.

How to configure bettercap

  • api.rest.address127.0.0.1Address to bind the API REST server to.
  • api.rest.alloworigin*Value of the Access-Control-Allow-Origin header of the API server.
  • api.rest.certificateAPI TLS certificate (will be auto generated if not existing), fill to enable HTTPS.
  • api.rest.certificate.bits4096Number of bits of the RSA private key of the generated HTTPS certificate.
  • api.rest.certificate.commonnamebettercapCommon Name field of the generated HTTPS certificate.

bettercap releases & version history

@ Every self-hosted release, weekly

One Monday email with the week's stable releases across the directory.

More in Network Security

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…