macOS
1. Download the macOS .dmg build for Hedgehog
2. Open the .dmg file and drag Hedgehog into your Applications folder
3. Launch Hedgehog from Applications or by running the command below
open -a Hedgehog
Linux
1. Download the Linux .AppImage build. Kali Linux is recommended because it includes many testing tools out of the box
2. Make the AppImage executable by running chmod
First use
On first startup, you will be prompted to add the a license file which you have been provided.
Then follow the steps on screen to configure your model provider etc.
If you want Hedgehog to perform browser-assisted testing, you will need to configure a browser as mentioned below. This is not mandatory but recommended.
Please refer to the "Help" section in Hedgehog for more information.
Hedgehog uses a Chromium-based browser for web testing, but it doesn’t bundle one. Edit your workspace config file and add a terminal browser section.
macOS: ~/Library/Application Support/hedgehog/<workspace-id>.toml
Linux: ~/.config/hedgehog/<workspace-id>.toml
[terminal.browser]
channel = “chrome”
# executable_path = “/usr/bin/chromium”
Pick either channel or executable_path, not both. macOS defaults to channel = “chrome”; use executable_path for Chromium or Brave.
On Kali or Debian, install Chromium with sudo apt install chromium and set executable_path = “/usr/bin/chromium”.
Optional: add headless = true to hide the window or proxy = “http://127.0.0.1:8080” to route through Burp.
Restart the application after editing. If web testing fails to start, install a Chromium-based browser or fix the configured path.