> ## Documentation Index
> Fetch the complete documentation index at: https://specterops-fetch-json-component.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Running the Collector

> Run the JamfHound collector to gather data from your JAMF Pro tenant

<img noZoom src="https://mintcdn.com/specterops-fetch-json-component/pkiaFEhjWYPnhxMb/assets/enterprise-AND-community-edition-pill-tag.svg?fit=max&auto=format&n=pkiaFEhjWYPnhxMb&q=85&s=c83d7e4a67c741a979c0e77bf15c1252" alt="Applies to BloodHound Enterprise and CE" width="482" height="45" data-path="assets/enterprise-AND-community-edition-pill-tag.svg" />

This page covers downloading, configuring, and running the JamfHound collector against your JAMF Pro tenant.

## Dependencies

* Python3 - version 3.12 or newer
* Requests Module

### Auditor Account (Recommended)

Create a [new account](https://docs.jamf.com/10.36.0/jamf-pro/install-guide-linux/Jamf_Pro_User_Accounts_and_Groups.html) directly assigned or part of a group assigned the "Auditor" default JAMF Pro role with "Full Access".

This account will have restricted read permissions to JAMF Pro objects.

### Administrator Account

The JamfHound collector can authenticate using username and password for an account that has the default "Administrator" role with "Full Access" or member of a group with the "Administrator" role and "Full Access".

This is the least secure option and does not follow the best practice of least-privilege.

## Install JamfHound

Retrieve the latest version of the JamfHound collector.

```shell theme={null}
git clone https://github.com/SpecterOps/JamfHound.git
```

Ensure python3.12 or newer is installed and install the `requests` module.

```shell theme={null}
python3 -m pip install requests
```

## Run JamfHound

Username and password are used to authenticate to the tenant and run the collector.

```shell theme={null}
python3 main.py --username auditor1 --password "auditorPASS" --target https://mytenant.jamfcloud.com --collect
```

## Run JamfHound With Okta Edges

Run the `collect` command with the `--okta` argument to collect JAMF Pro data and prepopulate edges that allow creating hybrid paths to OktaHound ingested data:

```shell theme={null}
python3 main.py --username auditor1 --password $auditor_pass_var --target https://mytenant.jamfcloud.com --collect --okta
```

## Collection Output

JamfHound will create a local collection directory named with a timestamp for when it was run (for example, `Collection_2026_03_02_16_02_48`).

Within that directory will be the output file `JAMFCollection.json` that you can upload to BloodHound.