Installation Guide for macOS

The information in this document applies to version 7.1.6 of Syhunt Hybrid.
The information in this section applies to: macOS Sequoia and older.

Table of Contents

Introduction
Installing Syhunt on macOS (Apple Silicon or Intel)
Parallels Desktop: Installing Syhunt on Debian ARM64
Parallels Desktop: Installing Syhunt on Ubuntu or Kali Linux ARM64

Syhunt Hybrid 7.1.6 is compatible with macOS Sequoia and earlier versions of macOS. This is the Carbon version, which uses Wine for installation and runs on both Apple Silicon (via Rosetta) and Intel-based Macs. Alternatively, if you prefer to use virtualization, Syhunt Hybrid 7.1.6 can run on ARM64 Linux, such as Ubuntu, Debian or Kali Linux, within macOS using Parallels Desktop with a Pro license - the Standard license is not compatible.

Installing Syhunt on macOS (Apple Silicon or Intel)

  1. You must read and agree with the Syhunt EULA before continuing and executing any command-line in your operating system.
  2. Download Java for macOS (jre-[version]-macosx-x64.dmg) and install it (if you haven't done so already)
  3. If you have not done so yet, follow our quick guide to install Wine64 on macOS:
    1. macOS on Apple Silicon (M1, M2, M3 or M4)
    2. macOS on Intel (if you have an older Intel-based macOS)
  4. Install wget using the command:
    brew install wget
  5. Follow these simple steps to install Syhunt.
    1. After downloading the jar file, ctrl-click its icon and select Open to launch it.
    2. You should read carefully the EULA presented to you on installation before accepting it.
    3. It's an easy next-next-finish installation process. When you click Finish, Syhunt CLI tools are ready for use.
  6. Follow these steps to enable the web user interface of Syhunt.

Note: if you upgrade your macOS, and see the error "invalid active developer path” when attempting to scan a GIT repository, run the command xcode-select --install to fix this error related to the git command.

Parallels Desktop: Installing Syhunt on Debian ARM64

The information in this section applies to: Debain 12.6 ARM64 on Apple Silicon Macs using Parallels Desktop.

  1. Install Java (if you have not done so yet):
    sudo apt install default-jre
  2. (Optional) Install GIT (if you have not done so yet) if you plan to scan GIT repositories with Syhunt:
    sudo apt install git
  3. Enable and install Rosetta with the commands at the Rosetta section of this guide.
  4. Install Wine64 AMD64 version 8.0 -Debian 12.6 ARM64 will by default get version 8):
    sudo apt install wine64:amd64
    1. After you see the successfully installed message, run wine ipconfig and the Wine configuration will be updated. When it finishes, you will see the message: wine: configuration in... has been updated.
  5. Follow these simple steps to install Syhunt.
    1. After downloading the jar file, ctrl-click its icon and select Open to launch it.
    2. You should read carefully the EULA presented to you on installation before accepting it.
    3. It's an easy next-next-finish installation process. When you click Finish, Syhunt CLI tools are ready for use.
  6. Follow these steps to enable the web user interface of Syhunt.

Parallels Desktop: Installing Syhunt on Ubuntu or Kali Linux ARM64

The information in this section applies to: Ubuntu 24.04 ARM64 or Kali Linux 2024.2 ARM64 on Apple Silicon Macs using Parallels Desktop.

  1. You must read and agree with the Syhunt EULA before continuing and executing any command-line in your operating system.
  2. Create a separate VM for Syhunt.
  3. Run sudo apt-get update
  4. Install Java (if you have not done so yet) with the following settings and commands:
    1. Add once to your shell profile: 
    2. echo 'export JAVA_TOOL_OPTIONS="$JAVA_TOOL_OPTIONS -XX:UseSVE=0"' \
  | sudo tee /etc/profile.d/java-nosve.sh
    3. Reload your login environment (or just open a new terminal):
    4. source /etc/profile.d/java-nosve.sh
    5. Now install OpenJDK 17 JRE:
      sudo apt install openjdk-17-jre
    6. Run java --version to confirm that you have version 17 installed.
  5. If you have the Parallels free image Ubuntu with Rosetta, skip this step, otherwise you need to enable and install Rosetta with the commands at the Rosetta section of this guide.
  6. Now if you install Wine, it would get version 9, which doesn't works well with Rosetta. Use the commands at the end of this guide to enable Wine 8.
  7. Install Wine64 AMD64 version 8.0:
    1. sudo apt install libwine:amd64=8.0~repack-4 wine64:amd64=8.0~repack-4
    2. After you see the successfully installed message, run wine ipconfig and the Wine configuration will be updated. When it finishes, you will see the message: wine: configuration in... has been updated.
  8. Follow these simple steps to install Syhunt.
    1. After downloading the jar file, ctrl-click its icon and select Open to launch it.
    2. You should read carefully the EULA presented to you on installation before accepting it.
    3. It's an easy next-next-finish installation process. When you click Finish, Syhunt CLI tools are ready for use.
  9. Follow these steps to enable the web user interface of Syhunt.

Parallels Desktop: Enabling Rosetta

The information in this section applies to: Ubuntu 24.04 ARM or Kali Linux 2024.2 ARM64 on Apple Silicon Macs using Parallels Desktop.

  1. After the virtual machine has finished downloading and installing, shut it down. Then, open the VM settings and navigate to the Hardware tab. Under CPU & Memory, enable the option Use Rosetta to run x86_64 binaries. Once you've done that, start the virtual machine again.
  2. Install Rosetta with the following commands:
    1. wget https://kb.parallels.com/Attachments/kcs-193687/rosetta_x86_sources.sh
    2. chmod +x rosetta_x86_sources.sh
    3. sudo ./rosetta_x86_sources.sh enable
      After that, you should see the message AMD64 architecture enabled
    4. sudo apt update

Parallels Desktop: Installing Wine 8.0

The information in this section applies to: Ubuntu 24.04 ARM or Kali Linux 2024.2 ARM64 on Apple Silicon Macs using Parallels Desktop.

Note: This approach is intended for testing environments only. It involves installing Debian 12 “Bookworm” packages on Ubuntu 24.04 ARM or Kali Linux 2024.2 ARM64. While it currently works, mixing packages from different distributions is not a recommended or stable long-term solution. We're actively working on a cleaner, more compatible method and will update this guide as soon as it's available.

  1. Add the Debian 12 “bookworm” repository only for Wine:
    echo 'deb http://deb.debian.org/debian bookworm main contrib non-free non-free-firmware' |
  sudo tee /etc/apt/sources.list.d/debian-bookworm.list

sudo tee /etc/apt/preferences.d/99-wine8 <<'EOF'
Package: wine* libwine* fonts-wine*
Pin: release n=bookworm
Pin-Priority: 990

Package: *
Pin: release n=bookworm
Pin-Priority: 100
EOF
  2. Add Bookworm Repo with Correct GPG Key:
    sudo mkdir -p /etc/apt/keyrings && \
curl -fsSL https://ftp-master.debian.org/keys/archive-key-12.asc | gpg --dearmor | sudo tee /etc/apt/keyrings/debian-bookworm.gpg > /dev/null && \
echo "deb [signed-by=/etc/apt/keyrings/debian-bookworm.gpg] http://deb.debian.org/debian bookworm main" | sudo tee /etc/apt/sources.list.d/debian-bookworm.list && \
sudo apt update
  3. Create the file /etc/apt/sources.list.d/ubuntu-amd64.list and adds the correct entries for amd64 packages:
    sudo tee /etc/apt/sources.list.d/ubuntu-amd64.list > /dev/null <<EOF
deb [arch=amd64] http://archive.ubuntu.com/ubuntu noble main restricted universe multiverse
deb [arch=amd64] http://archive.ubuntu.com/ubuntu noble-updates main restricted universe multiverse
deb [arch=amd64] http://archive.ubuntu.com/ubuntu noble-security main restricted universe multiverse
deb [arch=amd64] http://archive.ubuntu.com/ubuntu noble-backports main restricted universe multiverse
EOF
  4. Update APT again:
    sudo apt update
  5. Now run apt-cache madison wine | grep 8.0 and it should list 8.0~repack-4 as available and you can move to the next step.

Contact Us

Contact