User Tools

Site Tools


install_aircrack

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
install_aircrack [2014/04/01 06:52] – [Current version] Updated for 1.2-beta3 mister_xinstall_aircrack [2023/03/03 16:47] (current) – Remove packagecloud mister_x
Line 1: Line 1:
 ====== Installing Aircrack-ng from Source ====== ====== Installing Aircrack-ng from Source ======
-===== Requirements ===== 
-==== Linux ==== 
  
-  * Kernel headers and gcc as well as make have to be installed on your systemOn Debian-based distros (Debian, Ubuntu, Xubuntu, ...), issue the following command in a console to install them:+Legacy information can be found [[install_aircrack_old|here]].
  
-  sudo apt-get install build-essential+===== Requirements =====
  
-  * OpenSSL (development). It is called openssl-dev or libssl-dev depending on your distribution.+  * Autoconf 
 +  * Automake 
 +  * Libtool 
 +  * shtool 
 +  * OpenSSL development package or libgcrypt development package.
   * pkg-config   * pkg-config
-\\ 
-The following is required only if you want [[Airolib-ng]]: 
  
-  * [[http://www.sqlite.org|SQLite]] (development) > 3.3.17 (but latest version is recommended)+==== Linux ====
  
-==== Windows ====+  * Airmon-ng requires ethtool and rfkill 
 +    * If USB bus is present, lsusb 
 +    * If PCI/PCIe bus is present, lspci 
 +  * LibNetlink 1 (libnl-dev) or 3 (libnl-3-dev and libnl-genl-3-dev) development packages. It can be disabled by passing --disable-libnl to configure. 
 +  * Kernel headers and gcc as well as make have to be installed on your system (build-essential on Debian based distributions) 
 +  * make and Standard C++ Library development package (Debian: libstdc++-dev)
  
-It requires additional libraries to be installed: +==== Windows (Cygwin====
-  * [[http://www.openssl.org|OpenSSL]] (development): openssl-devel +
-\\ +
-The following is required only if you want [[Airolib-ng]]:+
  
-  * SQLite3 (development) > 3.3.17 (but latest version is recommended): libsqlite3-devel+  * w32api is required 
 +  * if using clang, libiconv and libiconv-devel 
 +  * make and Standard C++ Library development package
  
-==== OS X ====+==== MacOS ====
  
-Install the following via macports:+Install the following via Homebrew (brew):
  
-  * gmake 3.81+  * autoconf 
 +  * automake 
 +  * libtool 
 +  * openssl 
 +  * shtool 
 +  * pkg-config 
 +  * hwloc 
 +  * pcre
   * sqlite3   * sqlite3
 +  * libpcap
 +  * cmocka (optional)
  
-===== Compiling and installing =====+==== FreeBSD, OpenBSD, NetBSD, Solaris ====
  
-**Note:** For OS X, use 'gmake' instead of 'make'.+Install the following via pkg:
  
-==== Current version ====+  * gmake 
 +  * pkgconf 
 +  * pcre 
 +  * sqlite3 
 +  * gcc9 (or better)
  
-It requires some additional libraries: +===== Optional stuff =====
-  * OpenSSL (libssl-dev on Debian-based system) +
-  * SQLite > 3.3.17 (latest version is recommended) if you want to use [[Airolib-ng]]+
  
-   wget http://download.aircrack-ng.org/aircrack-ng-1.2-beta3.tar.gz +  * If you want SSID filtering with regular expression in airodump-ng (-essid-regex) pcre development package is required
-   tar -zxvf aircrack-ng-1.2-beta3.tar.gz +  * 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) 
-   cd aircrack-ng-1.2-beta3 +  * If you want to use Airpcap, the 'developer' directory from the CD is required. It can be downloaded [[https://support.riverbed.com/content/support/software/steelcentral-npm/airpcap.html|here]]. 
-   make +  * For best performance on FreeBSD (50-70% more), install gcc5 via: pkg install gcc5 Then compile with: gmake CC=gcc5 CXX=g++5 
-   make install+  * rfkill 
 +  * CMocka 
 +  * hwloc: strongly recommended, especially on high core count systems where it may give a serious performance boost
  
-==== Compiling with Airolib-ng support ==== 
  
-Simply append 'sqlite=true' parameter to make and make install:+===== Compiling and installing =====
  
-  make sqlite=true +Notes: 
-  make sqlite=true install+  * On OS X, *BSD and Solaris, use 'gmake' instead of 'make'. 
 +  * In order to compile with clang instead of gcc, add 'CC=clang CXX=clang++' to the configure command.
  
-=== OS X === +==== Current version ====
-Change CFLAGS in src/Makefile to point to the macpports install of SQLite3 before compiling. Change the following line: +
- +
-  CFLAGS +-Iinclude +
- +
-to +
- +
-  CFLAGS +-Iinclude -arch i386 -I/opt/local/include -L/opt/local/lib+
  
 +   wget https://download.aircrack-ng.org/aircrack-ng-1.7.tar.gz
 +   tar -zxvf aircrack-ng-1.7.tar.gz
 +   cd aircrack-ng-1.7
 +   autoreconf -i
 +   ./configure --with-experimental
 +   make
 +   make install
 +   ldconfig
  
 ==== Compiling with AirPcap support (cygwin only) === ==== Compiling with AirPcap support (cygwin only) ===
  
   - Copy 'developer' directory from the [[airpcap|AirPcap]] CD at the same level as 'Aircrack-ng' directory   - Copy 'developer' directory from the [[airpcap|AirPcap]] CD at the same level as 'Aircrack-ng' directory
-  - Append 'airpcap=true' parameter to make:+  - Append '- -with-airpcap=../developer' parameter to configure:
  
-  make airpcap=true +==== Compiling on *BSD ====
-  make install+
  
-==== Compiling with Airolib-ng and AirPcap support (cygwin only====+Commands are exactly the same as Linux but instead of **make**, use **gmake** (with **CC=gcc5 CXX=g++5** or any more recent gcc version installed).
  
-Simply append both parameter to make and make install:+==== Compiling on MacOS ====
  
-  make sqlite=true airpcap=true +Commands are exactly the same as Linux 
-  make sqlite=true install+==== Latest Git (development) Sources ====
  
-==== Compiling with CUDA support - Not supported ====+**Note:** Compilation parameters can also be used with the sources from our git repository.
  
-This is still under heavy development so it is not yet been added to the backtrack repositories however it deserves mentioning. Aircrack-ng can be built with a switch to add [[http://en.wikipedia.org/wiki/Graphics_processing_unit|GPU]] acceleration. In order to do this we need to grab Aircrack-ng from SVN (subversion)You must have the [[https://developer.nvidia.com/what-cuda|CUDA]] toolkit and the sdk already installed to be able to build this.+  git clone https://github.com/aircrack-ng/aircrack-ng 
 +  cd aircrack-ng 
 +  autoreconf -i 
 +  ./configure --with-experimental 
 +  make 
 +  make install 
 +  ldconfig
  
-   svn co http://svn.aircrack-ng.org/branch/aircrack-ng-cudaaircrack-ng-cuda+==== ./configure flags ====
  
-Next we will build it like normal but it needs a few extra arguments:+When configuring, the following flags can be used and combined to adjust the suite to your choosing:
  
-   cd aircrack-ng-cuda +  * **with-airpcap=DIR**: needed for supporting airpcap devices on windows (cygwin or msys2 only) Replace DIR above with the absolute location to the root of the extracted source code from the Airpcap CD or downloaded SDK available online. Required on Windows to build besside-ng, besside-ng-crawler, easside-ng, tkiptun-ng and wesside-ng when building experimental tools. The developer pack (Compatible with version 4.1.1 and 4.1.3) can be downloaded at https://support.riverbed.com/content/support/software/steelcentral-npm/airpcap.html
-   CUDA=true make +
-   make CUDA=true sqlite=true unstable=true install+
  
-Also see: [[http://www.offensive-security.com/documentation/backtrack-4-cuda-guide.pdf|BackTrack 4 CUDA Guide]]+  * **with-experimental**needed to compile tkiptun-ng, easside-ng, buddy-ng, buddy-ng-crawler, airventriloquist and wesside-nglibpcap development package is also required to compile most of the tools. If not present, not all experimental tools will be built. On Cygwin, libpcap is not present and the Airpcap SDK replaces it. See --with-airpcap option aboveOn debian based distro, install libpcap-dev
  
-==== Latest SVN (development) Sources ====+  * **with-ext-scripts**: needed to build airoscript-ng, versuck-ng, airgraph-ng and airdrop-ng. Note: Each script has its own dependencies. Note: It's only required in install phase.
  
-  svn co http://svn.aircrack-ng.org/trunk/ aircrack-ng +  * **with-gcrypt**Use libgcrypt crypto library instead of the default OpenSSLAnd also use internal fast sha1 implementation (borrowed from GIT) Dependency (Debian): libgcrypt20-dev
-  cd aircrack-ng +
-  make +
-  make install+
  
-==== Latest SVN with Airolib-ng support and experimental (unstable) programs (requires SQLite installed) ==== +  * **with-duma**: Compile with DUMA support. DUMA is a library to detect buffer overruns and under-runs. Dependencies (debian): duma
-(like [[tkiptun-ng|Tkiptun-ng]], [[easside-ng|Easside-ng (and buddy-ng)]], [[wesside-ng|Wesside-ng]] and [[besside-ng|Besside-ng]])+
  
-  make sqlite=true unstable=true +  * **with-xcode**: Set this flag to true to compile on OS X with Xcode 7+.
-  make sqlite=true unstable=true install+
  
-==== Latest SVN with Airolib-ng and and experimental (unstable) programs plus external scripts ==== +  * **disable-libnl**: Set-up the project to be compiled without libnl (1 or 3). Linux option only.
-(like [[airoscript-ng|Airoscript-ng]], [[tools#versuck-ng|Versuck-ng]], [[airgraph-ng|Airgraph-ng]] and [[airdrop-ng|Airdrop-ng]])+
  
-  make sqlite=true unstable=true ext_scripts=true +  * **without-opt**: Do not enable stack protector (on GCC 4.9 and above).
-  make sqlite=true unstable=true ext_scripts=true install+
  
-**Note:** Experimental scripts: +  * **enable-shared**: Make OSdep a shared library.
-  * Each scripts has its own dependencies, for details refer to the "README" file contained in their folder+
  
-==== Nightly Build ====+  * **disable-shared**: When combined with enable-static, it will statically compile Aircrack-ng.
  
-http://nightly.aircrack-ng.org/ contains a nightly tarball from each day. This is handy if you don't have access to SVN (subversion). Just download and build per building the current version instructions. Optionally you can enable the extra features with "sqlite=true" and "unstable=true" per above.+  * **with-avx512**On x86, add support for AVX512 instructions in aircrack-ng. Only use it when the current CPU supports AVX512.
  
-==== Legacy ====+  * **with-static-simd=**: Compile a single optimization in aircrack-ng binary. Useful when compiling statically and/or for space-constrained devices. Valid SIMD options: x86-sse2, x86-avx, x86-avx2, x86-avx512, ppc-altivec, ppc-power8, arm-neon, arm-asimd. Must be used with --enable-static --disable-shared. When using those 2 options, the default is to compile the generic optimization in the binary. **--with-static-simd** merely allows to choose another one.
  
-   wget http://download.aircrack-ng.org/aircrack-ng-0.9.3.tar.gz +  * **enable-maintainer-mode**: It is important to enable this flag when developing with Aircrack-ng. This flag enables additional compile warnings and safety features.
-   tar -zxvf aircrack-ng-0.9.3.tar.gz +
-   cd aircrack-ng-0.9.+
-   make +
-   make install+
  
 ===== Troubleshooting Tips ===== ===== Troubleshooting Tips =====
 +==== error while loading shared libraries: libaircrack-ng.so.0 ====
 +
 +Run **ldconfig** as root or with "sudo" to solve the issue.
 +
 ==== "command not found" error message ==== ==== "command not found" error message ====
  
Line 153: Line 166:
 It should show something like: It should show something like:
  
-   /usr/kerberos/sbin:/usr/kerberos/bin:/usr/lib/ccache:/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin:/root/bin+   /usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
  
 At this point compare the actual locations with the directories in your PATH. If the directories are missing from your PATH then you have a few options: At this point compare the actual locations with the directories in your PATH. If the directories are missing from your PATH then you have a few options:
Line 159: Line 172:
   * Add the directories to your PATH.  See the one or more of the following web sites for details of how to do this:   * Add the directories to your PATH.  See the one or more of the following web sites for details of how to do this:
  
-   http://www.linuxheadquarters.com/howto/basic/path.shtml +   https://www.cyberciti.biz/faq/howto-print-path-variable/
-   http://www.cyberciti.biz/faq/howto-print-path-variable/+
    http://www.troubleshooters.com/linux/prepostpath.htm    http://www.troubleshooters.com/linux/prepostpath.htm
-   http://linux.about.com/od/linux101/l/blnewbie3_1_4.htm 
  
   * Change to the particular directory with "cd" and then run the commands from within the directory. Don't forget to add "./" in front of each command.   * Change to the particular directory with "cd" and then run the commands from within the directory. Don't forget to add "./" in front of each command.
Line 168: Line 179:
   * Specify the full path for each command.  So if Aircrack-ng is located in the "/usr/local/bin" directory then run the command as "/usr/local/bin/aircrack-ng".   * Specify the full path for each command.  So if Aircrack-ng is located in the "/usr/local/bin" directory then run the command as "/usr/local/bin/aircrack-ng".
  
-  * Specify the location prefix when installing.  Lets say you have /usr/bin and /usr/sbin directories in your PATH, then do "make prefix=/usr install". This will install the programs to /usr/bin and /usr/sbin.+====== Installing pre-compiled binaries ======
  
-==== "build" - No such file or directory ==== +===== Linux/BSD/OSX =====
-On Debian-based distros, if you get something similar to:\\+
  
-  /bin/sh: line 0: cd: /lib/modules/2.6.15-28-amd64-generic/build: No such file or directory +With the exception of Linux penetration testing distributions, packages are usually out of date (MacOS is the exception)In this case, uninstalling the package and installing from sources is the recommended way to go.
-  Makefile.inc:66: *** /lib/modules/2.6.15-28-amd64-generic/build is missing, please set KERNELPATH. +
-  Stop.+
  
-Solution: +On MacOS, install it is via [[https://www.macports.org/|Macports]] or [[https://brew.sh/|brew]]. Simply do "brew install aircrack-ng" or "sudo ports install aircrack-ng"
- +
-The build directory gets installed together with the kernel headersso either you lack the correct headers or your KERNELPATH is wrong.  Please check that `uname -r` returns "2.6.15-28-amd64-generic"+
- +
-Do a "sudo apt-get install linux-headers-`uname -r`" or just "sudo apt-get install linux-headers"+
- +
-If uname returns exactly that string and the current headers are installed, the remove the headers and install them again. Also check /usr/src for installed header files, maybe it got mixed up for whatever reason. +
- +
-In the above examples, needless to say, change "2.6.15-28-amd64-generic" to whatever you are running. +
- +
-==== "openssl/hmac.h" - No such file or directory ==== +
- +
-If you get something similar to:\\ +
- +
-   crypto.h:12:26: error: openssl/hmac.h: No such file or directory +
-   crypto.h:13:25: error: openssl/sha.h: No such file or directory +
-   crypto.h:15:25: error: openssl/rc4.h: No such file or directory +
-   crypto.h:16:25: error: openssl/aes.h: No such file or directory +
- +
-Solution: +
-You are missing the OpenSSL development package.  Depending on the distribution, download and install openssl-devel or libssl-devel (libssl-dev /Ubuntu/). Or worst case, install it from source: http://www.openssl.org+
- +
-==== "zlib.h" No such file or directory ==== +
- +
-If you get something similar to: +
- +
-   wesside-ng.c:54:18: error: zlib.h: No such file or directory +
- +
-Solution: +
-You are missing the zlib development package. Depending on the distribution, download and install zlib-devel.  Or worst case, install it from source: http://www.zlib.net. +
- +
-==== "__le64" error on 64 bit machines when compiling ==== +
- +
-You get something similar to: +
- +
-   radiotap-parser.h:29: error: conflicting types for ‘__le64’ +
-   /usr/include/linux/types.h:158: error: previous declaration of ‘__le64’ was here +
- +
-See [[http://forum.aircrack-ng.org/index.php?topic=3311.0|this thread]] for a solution. +
- +
-====== Installing pre-compiled binaries ====== +
-===== Linux ===== +
- +
-Open your package manager and install 'Aircrack-ng' package. Be sure to check that the version offered is up-to-date -- you may see problems with older versions, especially if you have a card for which support was added recently, e.g. ACX, Broadcom or Intel. Ubuntu and Debian are particularly problematic in this matter.+
  
 ===== Windows ===== ===== Windows =====
 The Windows version of the Aircrack-ng suite does not have an install program. You must manually install (unzipping archive) the software. The Windows version of the Aircrack-ng suite does not have an install program. You must manually install (unzipping archive) the software.
  
-Here are the steps to follow for Windows XP:+Here are the steps to follow for Windows:
  
-  * Download the latest version of the Aircrack-ng suite for Windows to your PC. The link for the zip file can be found on the [[http://aircrack-ng.org|Wiki home page]].+  * Download the latest version of the Aircrack-ng suite for Windows to your computer. The link for the zip file can be found on the [[https://aircrack-ng.org|Wiki home page]].
  
-  * Unzip the contents of the Aircrack-ng zip file into "C:\". This will create a directory called "aircrack-ng-0.9.3-win". This directory name will vary based on the exact version that you downloaded.  This main directory contains three subdirectories - "bin", "src" and "test".+  * Unzip the contents of the Aircrack-ng zip file into "C:\". This will create a directory called "aircrack-ng-1.6-win". This directory name will vary based on the exact version that you downloaded.  This main directory contains three subdirectories - "bin", "src" and "test".
  
-Prior to using the software, make sure to install the drivers for your particular wireless card. See this [[install_drivers#windows|link]] for the instructions.+Prior to using the software, make sure to install the drivers for your particular wireless card. See this [[install_drivers#windows|link]] for the instructions. We currently only support Airpcap; other adapters may be supported but require development of your own DLL so the different tools can interact with it.
  
-To now use the Aircrack-ng suite, start Windows Explorer and double click on **Aircrack-ng GUI.exe** inside "bin" subdirectory.  The GUI requires [[http://www.microsoft.com/downloads/details.aspx?familyid=0856eacb-4362-4b0d-8edd-aab15c5e04f5&displaylang=en|.NET Framework 2.0]] to run (.NET Frameworks 1.0/1.1 are not able to run this executable, 2.0 or better **MUST** be installed).+To now use the Aircrack-ng suite, start Windows Explorer and double click on **Aircrack-ng GUI.exe** inside "bin" subdirectory.  The GUI requires .NET version 4.6.1 to run.
  
-Alternatively, open a command prompt (Start menu -> Execute -> cmd.exe) and change to the  "C:\aircrack-ng-0.9-win\bin" directory and execute the individual commands. +Alternatively, open a command prompt (Start menu -> Execute -> cmd.exe) and change to the  "C:\aircrack-ng-1.6-win\bin" directory and execute the individual commands. 
 \\ \\
 \\ \\
 \\ \\
-**Important notes**: +**Important notes**: 
 +  * [[airmon-ng|Airmon-ng]] is a Linux/FreeBSD tool only.
   * Remember that Windows only supports a limited subset of the commands.   * Remember that Windows only supports a limited subset of the commands.
   * Some troubleshooting tips specific to XP and Vista can be found on this [[airodump-ng|page]].   * Some troubleshooting tips specific to XP and Vista can be found on this [[airodump-ng|page]].
- 
-====== Installing on Mac OSX ====== 
- 
-The simplest and easiest way to install on Mac OS X is via [[http://www.macports.org/|Macports]]. You simply do "sudo port install aircrack-ng". 
- 
-Alternatively, use the following instructions: 
- 
-Make sure you have Xcode installed on your Mac, which can be found on the installer CD/DVD which came with your Mac. 
-After getting the source you can do a simple "make && sudo make install" from the untarred directory. 
-When you use the stable, you need to rename the Makefile.osx to Makefile and when you use the dev version it will autodetect you are using Darwin and compile fine. 
- 
-Mind you, airodump-ng and aireplay-ng are linux only and will not work under OSX native, so for reinjecting and sniffing you will have to use other means. 
- 
-If you have an intel Mac check out the VMware Fusion option which is mentioned lower on this page. 
- 
-Optional is openssl-dev and sqlite3 which can be installed through fink  
- 
-====== Installing on OpenBSD ====== 
- 
-See this [[http://forum.aircrack-ng.org/index.php?topic=4658.0|thread]] for instructions on installing and using the Aircrack-ng suite on OpenBSD. 
- 
-====== Installing VMware Image ====== 
- 
-**Important Note**: Virtualization solutions (VMware/VirtualBox/Virtual PC/...) only work with USB cards.  Card that are PCI/MiniPCI/PCMCIA/CardBus/Express Card/PCI Express/PCI-X/MiniPCI Express won't work at all. 
- 
-===== Requirements ===== 
- 
-  * VMWare Workstation 6.02, VMWare Player 2.02 (freeware) or VMWare Fusion beta for intel based Mac's 
-  * Wireless USB with one of the following chipsets: 
-    * rtl8187 
-    * rt2570 
-    * rt73 
-  * Approximately 2Gb of hard disk space 
- 
-**Important note:** VMWare Workstation 6.5 (and maybe Player 2.5 too) is known not to work correctly with rtl8187 driver.  It uses the whole CPU and it seems to be hanging (it is really slow) for an unknown reason. 
-===== Starting ===== 
- 
-  - Install VMWare Workstation or Player 
-  - Download this VMware image [[http://download.aircrack-ng.org/vmware-aircrack-ng-v4.7z|here]] or via [[http://www.fulldls.com/download-app-1882388-vmwareaircrackngv4+7z.torrent|BitTorrent]] and unpack it somewhere. 
-  - Start VMware and select "open". (Open the virtual machine) 
-  - Attach your USB adapter. 
-  - If the USB adapter is recognized automatically you'll find a small USB icon in the lower right corner of your VMWare window.  If not you have to attach it manually. 
- 
-**Notes:** 
-  * Uncompress the file on a filesystem that supports large files; NTFS, ext3, ... (all FAT filesystems, including FAT32, do not support large files). 
-  * Use [[http://www.7-zip.org|7-zip]] or [[http://www.rarlab.com/|Winrar]] (at least latest stable version) on Windows.  For Linux (and other OSes), use [[http://p7zip.sourceforge.net/|p7zip]] (it should be in the repositories of your distribution). 
-  * Here are a few reasons why the download doesn't work: 
-    * That sounds logical but make sure the URL is correct. 
-    * Check your DNS, make sure it can resolve "download.aircrack-ng.org" (by the way, the server answers to ping).  If it doesn't, use [[http://www.opendns.org|OpenDNS]] (Primary: 208.67.222.222 - Secondary: 208.67.220.220). 
-  * You don't need any driver for wireless adapters (and other USB adapters) on the OS running VMware. 
-  * The login credentials for the image are user id "root" with password "root". On some versions the password is "toor". 
-  * The [[faq#is_vmware_supported|FAQ]] has some limited information about running the Aircrack-ng suite under VMWare. 
- 
-===== Manually attaching USB device ===== 
- 
-On VMware Player, the device should be shown in the title bar, click on it to activate it. 
-On VMware Workstation, use menu "VM --> Removable devices --> USB" and then select the device: 
- 
-{{ http://pictures.aircrack-ng.org/other/vmware_usb.jpg }} 
- 
-It will automatically unplug the device from Windows and attach it to the virtual machine. 
- 
-===== Loading Wireless Device Drivers ===== 
- 
-The drivers can be loaded via the menu inside the VM: 
- 
-{{ http://pictures.aircrack-ng.org/other/vmware_aircrack_menu.jpg }} 
install_aircrack.1396327920.txt.gz · Last modified: 2014/04/01 06:52 by mister_x