Getting started

Rohan Vazarkar edited this page Apr 15, 2018 · 33 revisions

Getting started with BloodHound is very simple. Once complete, head over to the Data Collection section to start collecting data, or check out the included database using BloodHound.


Windows

This video demonstrates step-by-step the neo4j setup process: https://youtu.be/o22EMEUbrNk

  1. Neo4j requires Java, so make sure you're running the latest version of Java.

  2. Go to neo4j.com/download and click on "Download Server"

  3. Download the current version of neo4j Server for Windows, selecting either 32 or 64 bit.

  4. Extract the contents of the zip folder you downloaded in step 4.

  5. Open cmd.exe running as an administrator, and navigate to the folder you extracted the zip into in step 4.

  6. CD into the bin directory, and install neo4j as a service by running neo4j.bat install-service

  7. Download/clone the BloodHound GitHub repo, then copy BloodHoundExampleDB.graphdb into the data\databases folder within the neo4j directory.

  8. In cmd.exe, go back up a directory then cd into the conf directory. Open neo4j.conf, and uncomment the line #dbms.active_database=graph.db. Change this line so it reads as dbms.active_database=BloodHoundExampleDB.graphdb. Also uncomment the line #dbms.allow_upgrade=true so that it reads as dbms.allow_upgrade=true, then save this file.

  9. Go back to cmd.exe and start neo4j by typing net start neo4j

  10. Verify neo4j is running by navigating to http://localhost:7474/ in a browser. The neo4j web console should show up here.

  11. Run BloodHound.exe from the release found here or build BloodHound from source.

  12. Authenticate to the provided sample graph database at bolt://localhost:7687. The username is "neo4j", and the password is "BloodHound".

You're now ready to get started with data collection!


Linux

For much better instructions on setting up BloodHound on Linux, see this blog post: https://stealingthe.network/quick-guide-to-installing-bloodhound-in-kali-rolling/

  1. Download and install neo4j community edition.

    Optional: configure the REST API to accept remote connections if you plan to run neo4j and the PowerShell ingestor on different hosts.

  2. Clone the BloodHound GitHub repo.

    git clone https://github.com/adaptivethreat/Bloodhound

  3. Start the neo4j server, pointing neo4j to the provided sample graph database.

  4. Run BloodHound from the release found here or build BloodHound from source.

    ./BloodHound

  5. Authenticate to the provided sample graph database at bolt://localhost:7687. The username is "neo4j", and the password is "BloodHound".

You're now ready to get started with data collection!


OSX

  1. Download and install neo4j community edition.

    Optional: configure the REST API to accept remote connections if you plan to run neo4j and the PowerShell ingestor on different hosts.

  2. Clone the BloodHound GitHub repo.

    git clone https://github.com/adaptivethreat/Bloodhound

  3. Start the neo4j server, pointing neo4j to the provided sample graph database.

  4. Run the BloodHound App from the release found here or build BloodHound from source.

  5. Authenticate to the provided sample graph database at bolt://localhost:7687. The username is "neo4j", and the password is "BloodHound".

You're now ready to get started with data collection!

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.