> ## 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.

# Getting Started

> Learn how to get started with JamfHound, an OpenGraph extension and data collector for JAMF Pro.

<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" />

## Prerequisites

Before you begin, ensure that the following prerequisites are met:

| Prerequisite                                                                        | Description                                                                                  |
| ----------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
| [Ensure graph database is PostgreSQL](/opengraph/requirements#version-requirements) | For best performance, BloodHound requires PostgreSQL as the graph database rather than Neo4j |
| [Configure and run the collector](/opengraph/extensions/jamfhound/collect-data)     | Collects data from your JAMF Pro tenant and generates JSON files for upload to BloodHound    |

## Register the Extension (BloodHound Enterprise Only)

The BloodHound extension feature is currently available in preview exclusively for BloodHound Enterprise customers. To get started, contact your account team.

The JamfHound extension includes a schema that tells BloodHound how to model and analyze data from your JAMF Pro tenant. You must register the extension before you upload data generated by the JamfHound collector.

On the **OpenGraph Management** page, upload the JamfHound schema file (`bhe-jamfhound-extension.json`).

## Register Custom Node Icons (Community Edition Only)

Skip this step if you already uploaded an extension schema, as the schema registers the node icons automatically.

If you haven't registered an extension schema, register the JamfHound custom node types using the [create\_jamf\_icons.py script](https://github.com/SpecterOps/JamfHound/blob/main/lib/create_jamf_icons.py).

## Upload Data to BloodHound

After you complete the prerequisites and register the extension or node icons, upload the data collected by JamfHound to BloodHound.

Upload the generated `Collection_xx_xx/JAMFcollection.json` file from the output directory to BloodHound.

## Import Cypher Queries

JamfHound provides [custom Cypher queries](/opengraph/extensions/jamfhound/reference/queries) to help you identify attack paths and misconfigurations in your JAMF Pro tenant. These queries are included in the `custom-queries` directory of the JamfHound extension.

To use these queries, you must first [import](/analyze-data/explore/cypher-search#import-and-export) the `custom-queries/*.json` files into BloodHound. You can then run the queries on the **Explore** page.

<Note>Cypher queries that reference node or edge kinds not present in the database will fail without the extension schema (for example: `failed to translate kinds: unable to map kinds: Okta_ApiServiceIntegration`). Community Edition users can work around this by removing the unrecognized node and edge kinds from the queries until the extension schema becomes available for BloodHound Community Edition.</Note>

<Tip>JamfHound also provides [specialized queries](/opengraph/extensions/jamfhound/reference/privilege-zone-rules) in a separate `PrivilegeZoneRules` directory for creating or updating [Cypher-based](/analyze-data/privilege-zones/rules#cypher) Privilege Zone rules.</Tip>

## Next Steps

* Explore the [JamfHound node types](/opengraph/extensions/jamfhound/reference/schema#nodes) and [edge types](/opengraph/extensions/jamfhound/reference/schema#edges) in the schema reference
* Try the [JamfHound Cypher queries](/opengraph/extensions/jamfhound/reference/queries) on the **Explore** page
* Learn about [JAMF Pro attack paths](/opengraph/extensions/jamfhound/overview#jamf-attack-paths) and what to look for
* Use JamfHound's [specialized queries](/opengraph/extensions/jamfhound/reference/privilege-zone-rules) to create or update [Cypher-based](/analyze-data/privilege-zones/rules#cypher) Privilege Zone rules
* Join the `#jamf` channel on the [BloodHound Community Slack](https://slack.specterops.io/) for questions and discussion
