Skip to main content

​
Platforms Supported

Ghidra supports the following operating systems:
  • Windows 10 (build 1809 or later)
  • Linux (64-bit distributions)
  • macOS 10.13 or later
All 32-bit OS installations are now deprecated. Please contact the Ghidra team if you have a specific need for 32-bit support.

​
System Requirements

​
Hardware Requirements

  • RAM: 4 GB minimum (8 GB or more recommended)
  • Storage: 1 GB for installed Ghidra binaries
  • Display: Dual monitors strongly suggested for optimal workflow

​
Software Requirements

1

Java Development Kit (JDK) 21

A 64-bit JDK 21 is required. Free long-term support (LTS) versions are available from:
2

Python 3.9-3.13 (Optional)

Required for:
  • Debugger support
  • PyGhidra integration
Available from Python.org or your operating system’s package manager.

​
Installing JDK 21

​
Windows

1

Download JDK

Download the JDK 21 Windows installer (.msi or .exe) or zip file from Adoptium or Amazon Corretto
2

Extract or Install

If using a zip file:
  • Right-click on the zip file and click Extract All...
  • Click Extract
3

Configure PATH

Add the JDK to your system PATH:
  1. Right-click on Windows start button, and click System
  2. Click Advanced system settings
  3. Click Environment variables...
  4. Under System variables, highlight Path and click Edit...
  5. Click New and add <path-to-jdk>\bin
  6. Click OK on all dialogs
4

Verify Installation

Open a new Command Prompt and run:
java -version
You should see Java version 21.x.x

​
Linux and macOS

1

Download JDK

Download the JDK 21 tar.gz file from Adoptium or Amazon Corretto, or use your package manager:
# Ubuntu/Debian
sudo apt update
sudo apt install openjdk-21-jdk

# macOS with Homebrew
brew install openjdk@21
2

Extract (if manual install)

tar xvf <jdk-distribution.tar.gz>
3

Configure PATH

Add to your ~/.bashrc or ~/.zshrc:
export PATH=<path-to-jdk>/bin:$PATH
Save the file and reload your shell:
source ~/.bashrc
4

Verify Installation

java -version
You should see Java version 21.x.x

​
Installing Ghidra

1

Download Ghidra

Download a Ghidra release from the official GitHub releases page
Download the file named ghidra_<version>_PUBLIC_<date>.zip under the “Assets” drop-down. Do NOT download the “Source Code” files for installation.
2

Extract Ghidra

Extract the Ghidra distribution to your desired location using any unzip program:
# Linux/macOS
unzip ghidra_*_PUBLIC_*.zip
cd ghidra_*_PUBLIC

# Windows: Use built-in extraction or 7-Zip, WinZip, WinRAR
Do NOT extract Ghidra on top of an existing installation. Always extract to a new directory.
3

macOS: Remove Quarantine (if needed)

On macOS, you may need to remove the quarantine attribute before extraction:
xattr -d com.apple.quarantine ghidra_*_PUBLIC_*.zip

​
Installation Notes

Ghidra does not use a traditional installer program. It is simply extracted in-place on the filesystem. This means:
  • ✅ No administrative privileges required for personal use
  • ✅ No OS registry or system configuration changes
  • ✅ Easy removal by deleting the installation directory
  • ❌ No automatic desktop shortcuts or start menu entries

​
First Launch

1

Navigate to Installation Directory

cd <GhidraInstallDir>
2

Launch Ghidra

# Linux/macOS
./ghidraRun

# Windows
ghidraRun.bat
3

Accept User Agreement

On first launch, you’ll be prompted to accept the user agreement
4

Wait for Initialization

Ghidra will initialize and create necessary configuration directories
Ghidra will automatically locate a compatible JDK on your system. If multiple Java versions are installed, Ghidra will use the one on your PATH or specified by the JAVA_HOME environment variable.

​
Building Native Components (Optional)

Ghidra includes pre-built native binaries for common platforms. If you’re on an unsupported platform or the pre-built binaries don’t work, you can build them yourself.

​
Requirements for Building

  • JDK 21
  • Gradle 8.5+ (or use the included wrapper)
  • C/C++ compiler:
    • Windows: Microsoft Visual Studio 2017+ with MSVC, Windows SDK, and C++ ATL
    • Linux/FreeBSD: GCC or Clang, and make
    • macOS: Xcode or Command Line Tools for Xcode

​
Build Commands

cd <GhidraInstallDir>/support/gradle/

# If Gradle is installed
gradle buildNatives

# Or use the Gradle wrapper (requires internet)
./gradlew buildNatives  # Linux/macOS
gradlew.bat buildNatives  # Windows

​
Troubleshooting

​
Java Not Found

Problem: “The ‘java’ command could not be found in your PATH or with JAVA_HOME.” Solution: Install JDK 21 and ensure it’s on your PATH or set the JAVA_HOME environment variable.

​
Failed to Find Supported JDK

Problem: “Failed to find a supported JDK.” Solution: Ghidra requires JDK 21. Install a compatible version from Adoptium or Amazon Corretto.

​
Launch Fails Silently

Problem: “Exited with error. Run in foreground (fg) mode for more details.” Solution: Run Ghidra in debug mode to see error messages: 
./support/ghidraDebug

​
Windows: Path Contains Special Characters

Ghidra will not launch when its path contains a ! or ^ character. Choose an installation path without these characters.

​
Optional: Installing Python for Debugger Support

To use Ghidra’s integrated debugger and PyGhidra: 
# Install Python 3.9-3.13
# Linux (Ubuntu/Debian)
sudo apt install python3 python3-pip

# macOS
brew install [email protected]

# Windows: Download from python.org
The debugger requires additional packages: 
pip install protobuf>=3.20.3
pip install Pybag>=2.2.16  # For WinDbg support on Windows

​
Next Steps

With Ghidra installed, you’re ready to start analyzing binaries. Continue to the quickstart guide to learn how to create your first project and import a binary for analysis.

Build docs developers (and LLMs) love

Get started for freeTalk to us