Recon Essentials

Free attack surface management, on your own machine

Recon Essentials is the discovery and inventory part of Vulmon Recon, free and self-hosted with Docker. You add the domains and IP ranges you own. It keeps finding what is exposed — subdomains, IP addresses, open ports, websites, technologies and certificates — and shows changes as they happen.
The domain inventory: each subdomain with its scope, reachability, IP addresses, open ports and websites

What you get

Discovery, inventory and continuous monitoring of your external attack surface, with search, notes, tags, owners, users with roles and two-factor authentication.
  • Six inventory lists
    Domains, IP addresses, websites, technologies, ports and certificates. Every list can be searched, filtered and exported to CSV.
  • Scope review
    Asset Review shows what was found. You confirm which domains and IP addresses are yours, and those are monitored continuously.
  • Certificate and TLS findings
    Findings about certificates and TLS settings appear on the certificate and port pages.
  • Scan activity
    See what the engine has been doing and, when a scan fails, why it failed.
  • Reports
    Generate a report with an executive summary and your inventory whenever you need one.
  • It says what it could not check
    If the engine cannot measure something, for example because the container lacks a network privilege, the page says so instead of showing an empty result.

Discovery is not limited

The limits count only the assets you keep in scope and the seeds you add. Everything discovery finds is kept.
Limit Unregistered Registered (free)
Discovered assets domains + IP addressesUnlimitedUnlimited
In-scope assets domains + IP addresses1550
Seeds 45150

An asset is a domain or an IP address. When you reach the limit, nothing stops: discovery keeps running and new finds stay visible. You cannot put more assets in scope until you free a slot, or register to raise the limit.

Register for free to raise the limits to 50 in-scope assets and 150 seeds. Registering is optional: it takes an email address and an activation code, in the app under Settings → License. A registered installation renews its license once a day. Each renewal reports how many domains and IP addresses are in scope, out of scope and pending, and how many seeds there are — numbers only, never names.

Install with one command

You need Docker Engine 24 or later with Docker Compose v2: a Linux server, or Docker Desktop on macOS or Windows. Plan for 2 CPU cores, 4 GB of RAM and 10 GB of disk to start with.

Linux and macOS

curl -fsSL https://raw.githubusercontent.com/kontratek/recon-essentials/main/recon-essentials.sh | bash

Windows (PowerShell)

irm https://raw.githubusercontent.com/kontratek/recon-essentials/main/recon-essentials.ps1 | iex

On Windows, Docker Desktop must run Linux containers, which is its default. The Linux command also works there in Git Bash or WSL.

Run the command in the folder where the installation should go. It creates a recon-essentials folder there, checks Docker, generates the database password and asks one question: who will use it. Press Enter if only this computer will. Then it downloads the images, starts everything and opens Recon Essentials in your browser. It writes nothing outside that folder.

After that, the script in that folder starts Recon Essentials and opens it: recon-essentials.cmd on Windows, ./recon-essentials.sh on Linux and macOS. Run it whenever Recon Essentials does not open, for example after Docker was closed or an image was deleted. It never deletes data. It offers an upgrade when a new release is out, and it upgrades first only when the installed release is no longer supported. In between, Recon Essentials runs in the background and starts again with Docker.

Create the first administrator in the browser, then add your domains and IP ranges as seeds. Discovery then starts on its own.

Installation files and questions: GitHub. Images: Docker Hub. Upgrades, backups and restores: the installation guide.

Your data stays on your machine

Everything Recon Essentials finds is kept in a PostgreSQL database on your machine. It never uploads your assets.

Every outbound connection it makes is listed, with the reason for each one — in the documentation before you install, and in the product afterwards. The optional ones can be switched off.

Recon Essentials is not open source. Its use is governed by the Terms of Service.

When you need more

Vulmon Recon, the hosted product, gives better, more complete results, with nothing to install or maintain.
  • Vulnerability findings: CVE matching, severity scoring and issue tracking
  • Cloud connectors for AWS, Azure, GCP and Cloudflare accounts
  • Integrations: Jira, ServiceNow, GitHub Issues, GitLab Issues, Slack, Microsoft Teams, Zapier and MCP server
  • The public API, single sign-on and scheduled email reports
  • Nothing to install or maintain

Frequently asked questions

What people ask before they install a free attack surface management tool.

Is Recon Essentials free?

Yes. It is free to use, with no time limit and no payment details. Discovery is not limited: the limits count only the assets you keep in scope (15, or 50 after free registration) and the seeds you add (45, or 150).

Is Recon Essentials open source?

No. It is free and it runs on your own machine, but its source code is not published. Its use is governed by the Terms of Service.

What do I need to run it?

Docker Engine 24 or later with Docker Compose v2: a Linux server, or Docker Desktop on macOS or Windows. Plan for 2 CPU cores, 4 GB of RAM and 10 GB of disk.

Does it send my data to Vulmon?

No. Everything it finds stays in a PostgreSQL database on your machine. Without registration it only fetches a signed product manifest, which carries nothing about your installation. A registered installation also renews its license once a day and reports counts, never names.

Can other computers open it?

Yes. The install command asks who will use Recon Essentials. Choose other computers on the network, then give this computer's IP address or host name.

How is it different from Vulmon Recon?

Vulmon Recon is the hosted product. It adds vulnerability findings with CVE matching, cloud connectors, integrations, the public API, single sign-on and scheduled email reports, with nothing to install or maintain.

See what you expose

Install it with one command and add your domains and IP ranges. Discovery then starts on its own.