Skip to content

Latest commit

 

History

History
131 lines (84 loc) · 3.17 KB

install.md

File metadata and controls

131 lines (84 loc) · 3.17 KB

OWASP Logo OWASP Amass - Installation Guide

Packaging status Get it from the Snap Store

Prebuilt Binaries

A precompiled version is available with each release.

Using Docker

  1. Build the Docker image:
sudo docker build -t amass https://github.com/OWASP/Amass.git
  1. Run the Docker image:
sudo docker run amass enum --passive -d example.com

The wordlists maintained in the Amass git repository are available in /wordlists/ within the docker container. For example, to use all.txt:

sudo docker run amass enum -brute -w /wordlists/all.txt -d example.com

From Source

If you prefer to build your own binary from the latest release of the source code, make sure you have a correctly configured Go >= 1.10 environment. More information about how to achieve this can be found on the golang website. Then, take the following steps:

  1. Download OWASP Amass:
go get -u github.com/lanzay/Amass/...
  1. If you wish to rebuild the binaries from the source code:
cd $GOPATH/src/github.com/OWASP/Amass

go install ./...

At this point, the binaries should be in $GOPATH/bin.

  1. Several wordlists can be found in the following directory:
ls $GOPATH/src/github.com/lanzay/Amass/wordlists/

Packages Maintained by the Amass Project

Homebrew (macOS)

For Homebrew on Mac, the following two commands will install Amass into your macOS environment:

brew tap caffix/amass
brew install amass

Snapcraft

If your operating environment supports Snap, you can click here to install, or perform the following from the command-line:

sudo snap install amass

On Kali, follow these steps to install Snap and Amass + use AppArmor (for autoload):

sudo apt install snapd
sudo systemctl start snapd
sudo systemctl enable snapd
sudo systemctl start apparmor
sudo systemctl enable apparmor

Add the Snap bin directory to your PATH:

export PATH=$PATH:/snap/bin

Periodically, execute the following command to update all your snap packages:

sudo snap refresh

Packages Maintained by a Third-party

Arch Linux

Details regarding this package can be found here

BlackArch Linux

Details regarding this package can be found here

FreeBSD

cd /usr/ports/dns/amass/ && make install clean
pkg install amass

Nix or NixOS

nix-env -f '<nixpkgs>' -iA amass

Pentoo Linux

sudo emerge net-analyzer/amass

Periodically, execute the following command to update all packages:

sudo pentoo-updater