amass README

The project's README from github.com/owasp-amass/amass. As one markdown file: README.md.

OWASP Logo OWASP Amass Project

OWASP Flagship GitHub Release Go Report CodeFactor Follow on Twitter Chat on Discord

The OWASP Amass Project performs network mapping of attack surfaces and external asset discovery using open source information gathering and active reconnaissance techniques.

Installation Go Version Docker Image GitHub Downloads

You can find additional installation instructions and documentation in the Amass Docs repo.

Corporate Supporters

WhoisXML API Logo

Contributing Contribute Yes Chat on Discord

We are always happy to get new contributors on board! Please check CONTRIBUTING.md to learn how to contribute to our codebase, and join our Discord Server to discuss current project goals.

Troubleshooting GitHub Test Status codecov Chat on Discord

If you need help with installation and/or usage of the tool, please join our Discord server where community members can best help you.

:stop_sign: Please avoid opening GitHub issues for support requests or questions!

Licensing License

This program is free software: you can redistribute it and/or modify it under the terms of the Apache license. OWASP Amass and any contributions are Copyright © by Jeff Foley 2017-2026. Some subcomponents have separate licenses.

Network graph

amass (owasp-amass/amass)

information-gathering
Searching Database…

15.4K ·GitHub
What is this?Amass is an OWASP project that maps attack surfaces and discovers external assets (like subdomains, IPs, and infrastructure) using open source intelligence gathering and active reconnaissance.
Is this a CLI tool or does it run as a service?It's a command-line tool written in Go that you run locally against a target domain or organization to enumerate subdomains and map network infrastructure.
How do I install and run it?The README points to a separate Amass Docs repo for detailed installation and usage instructions; a Docker image is also available for containerized use.
Is there built-in support if I run into install or usage issues?The project directs support questions to its Discord server rather than GitHub issues, so there's no official issue-based support channel for troubleshooting.
Who is this built for?Security researchers, penetration testers, and OSINT practitioners who need to discover and map an organization's external attack surface.
Does it run on Linux and macOS, or just one platform?Being a Go CLI tool with an official Docker image, it runs cross-platform on Linux, macOS, and Windows.
Can I use the output with other recon tools like Maltego?Yes, Amass integrates with Maltego, as reflected in its own project topics, letting you visualize discovered assets within Maltego's graph interface.
Can I get support through GitHub issues?No, the maintainers explicitly ask users not to open GitHub issues for support or usage questions and to use the Discord server instead.
Size
384.2 MB
Stars
15.4K
Age
8y
Commits · 90 Days