mirror of https://github.com/laramies/theHarvester.git synced 2026-09-30 13:34:54 +02:00

Files

T

MattandGitHub 0d2ab5a0b3 Add the HarvestView web application (#2512 )

* feat: add HarvestView operator UI

* Use JSONL-only HarvestView file flows

* Drive HarvestView activities from the API catalog

* Add result action controls

* Render shared DNS resolver defaults

* Clarify resolver cardinality in HarvestView

* Load Tabulator from CDNjs

* Fix HarvestView wiki link

* Align HarvestView with execution status contract

* Add HarvestView import and action controls

* Harden HarvestView browser assertions

* Simplify HarvestView run selection

* Show truthful HarvestView execution outcomes

* refactor: show canonical URL results in HarvestView

* Show canonical hostname results in HarvestView

* test(harvestview): remove browser error race

2026-08-10 00:08:05 -04:00

3.2 KiB

Raw Blame History

Installation

theHarvester requires Python 3.12 or newer. Choose one installation lane and finish with its verification step.

Kali Linux package

Kali packages theHarvester directly:

sudo apt update
sudo apt install theharvester
theHarvester -h

If the installed command or available sources differ from the repository, update Kali first and check the packaged version. Package releases can lag behind the current master or dev branch.

Source installation with uv

Install uv, clone the repository, and install the locked runtime dependencies:

curl -LsSf https://astral.sh/uv/install.sh | sh
git clone https://github.com/laramies/theHarvester.git
cd theHarvester
uv sync
uv run theHarvester -h

Contributors should install the development groups instead:

uv sync --all-groups
uv run pytest

The supported console commands are theHarvester and restfulHarvest. There is no root theHarvester.py launcher.

Self-host Tabulator

HarvestView loads Tabulator 6.5.2 from CDNjs by default. For an isolated deployment, download the same pinned files in a connected environment and copy them into theHarvester/lib/api/static/harvestview/:

File	CDNjs source	SRI
`tabulator.min.css`	`https://cdnjs.cloudflare.com/ajax/libs/tabulator-tables/6.5.2/css/tabulator.min.css`	`sha512-t8I/asqzdu/MRgVLxVanQ/c5bhUA1qZ/zA432a/3nUh0kkd7P8Qch35wQvTODivf9D6Xv3h7F8p7ezcUyBOQrQ==`
`tabulator.min.js`	`https://cdnjs.cloudflare.com/ajax/libs/tabulator-tables/6.5.2/js/tabulator.min.js`	`sha512-AF0YMSgc0Ui4IJPb4hJNSi16wFidZEQa6ZTCAeguF3h5glVnAPuz/JT2ai9ypKhsc9n6CEXBB+tMdxsv1q+rxg==`

Then replace the two CDNjs tags in theHarvester/lib/api/static/harvestview/index.html with same-origin references:

<link rel="stylesheet" href="/static/harvestview/tabulator.min.css?v=6.5.2">
<script src="/static/harvestview/tabulator.min.js?v=6.5.2"></script>

Remove the CDN-only integrity, crossorigin, and referrerpolicy attributes from those local tags. Rebuild the package or container after copying the assets.

Screenshot support

The screenshot option requires a Playwright-compatible Chromium browser:

uv run playwright install chromium

On Linux, Playwright may report missing system libraries. Follow the host-specific dependency instructions printed by Playwright, then rerun the browser installation.

Docker Compose API service

The Docker image starts restfulHarvest; it does not open an interactive theHarvester CLI:

git clone https://github.com/laramies/theHarvester.git
cd theHarvester
docker compose up --build

Open http://127.0.0.1:5000/docs after the service starts.

The supplied Compose mapping publishes port 5000 on every host interface. For a local-only service, change it to:

ports:
  - "127.0.0.1:5000:80"

Do not expose the service directly to an untrusted network. Core query routes are not authenticated.

Next step

Continue with the Quick Start. Configure provider credentials only when needed; see Configuration and API Keys.

3.2 KiB Raw Blame History