Aircrack-ng is an 802.11 WEP and WPA-PSK keys cracking program that can recover keys once enough data packets have been captured. It implements the standard FMS attack along with some optimizations like KoreK attacks, as well as the all-new PTW attack, thus making the attack much faster compared to other WEP cracking tools.
It can attack WPA1/2 networks with some advanced methods or simply by brute force. It can also fully use a multiprocessor system to its full power in order to speed up the cracking process.
- OpenSSL development package or libgcrypt development package.
- Airmon-ng (Linux) requires ethtool.
- On windows, cygwin has to be used and it also requires w32api package.
- Linux: LibNetlink 1 or 3. It can be disabled by setting the flag 'libnl' to false.
- pkg-config (pkgconf on FreeBSD)
- FreeBSD, OpenBSD, NetBSD, Solaris and OS X with macports: gmake
- Linux/Cygwin: make and Standard C++ Library development package (Debian: libstdc++-dev)
- If you want SSID filtering with regular expression in airodump-ng (-essid-regex) pcre development package is required.
- If you want to use airolib-ng and '-r' option in aircrack-ng, SQLite development package >= 3.3.17 (3.6.X version or better is recommended)
- If you want to use Airpcap, the 'developer' directory from the CD is required.
- For best performance on FreeBSD (50-70% more), install gcc5 via: pkg install gcc5 Then compile with: gmake CC=gcc5 CXX=g++5
Compilation on *BSD or Solaris:
Strip debugging symbols:
When compile and installing, the following flags can be used and combined to compile and install the suite:
sqlite: Compile airolib-ng and add support for airolib-ng databases in aircrack-ng:
- Debian based distro: libsqlite3-dev
- FreeBSD: sqlite3
airpcap: needed for supporting airpcap devices on windows (cygwin only) REQUIREMENT: Copy 'developers' directory from Airpcap CD one level below this INSTALLING file Note: Not working yet.
experimental: needed to compile
wesside-ng. Building besside-ng-crawler requires LibPCAP (development package). On debian based distro, install libpcap-dev
ext_scripts: needed to build
airdrop-ng. Note: Experimental. Each script has its own dependences. Note: It's only required in install phase.
gcrypt: Use libgcrypt crypto library instead of the default OpenSSL. And also use internal fast sha1 implementation (borrowed from GIT) Dependency (Debian): libgcrypt20-dev
libnl: Add support for netlink (nl80211). Linux only.
- Dependencies (debian):
- LibNL 1:
- LibNL 3:
- LibNL 1:
pcre: Add support for regular expression matching for ESSID in airodump-ng and besside-ng. Dependencies (debian): libpcre3-dev
- Debian based distro: libpcre3-dev
- FreeBSD: pcre
duma: Compile with DUMA support. DUMA is a library to detect buffer overruns and under-runs. Dependencies (debian): duma
xcode: Set this flag to true to compile on OS X with Xcode 7+.
macport: Set this flag to true to compile on OS X with macports.
make sqlite=true experimental=true pcre=true
Compiling wth gcrypt:
make sqlite=true pcre=true experimental=true install
Installing, with external scripts:
make sqlite=true experimental=true ext_scripts=true
Testing (with sqlite, experimental and pcre)
make sqlite=true experimental=true pcre=true check
Compiling on OS X with macports (and all options):
gmake macport=true sqlite=true experimental=true pcre=true
Compiling on FreeBSD with better performance
gmake CC=gcc5 CXX=g++5
Automatic detection of CPU optimization is done at compile time. This behavior is not desirable when packaging Aircrack-ng (for a Linux distribution).
It can be overriden by creating common.cfg in the same directory as this file with the following settings when compiling on x86 (32 or 64 bit):
NEWSSE=false SIMDCORE=false PTHREAD=Y
Using precompiled binaries
- Use your package manager to download aircrack-ng
- In most cases, they have an old version.
- Install the appropriate "monitor" driver for your card (standard drivers doesn't work for capturing data).
- aircrack-ng suite is command line tools. So, you have to open a commandline
Start menu -> Run... -> cmd.exethen use them
- Run the executables without any parameters to have help
Documentation, tutorials, ... can be found on http://www.aircrack-ng.org
See also manpages and the forum.
For further information check the README file