# Installation

xrDebug is available as a self-contained binary, PHAR file, Composer package, Docker image, and source code. See run for instructions on how to run the software.

xrDebug is available for macOS, Linux, and Windows WSL. Access to the latest release (opens new window) artifacts at GitHub.

# Self-contained binary recommended

Download latest xrdebug binary by running the following command in your terminal, it detects your operating system and CPU architecture:

bash <(curl -sL xrdebug.com/bin.sh)

# Self-contained binary (manual)

Download latest xrdebug binary for your operating system and CPU architecture.

# macOS

xrDebug package for macOS includes a GUI install wizard. Open the .pkg file to start the installation.

CPU Download
Silicon xrdebug-macos-arm64.pkg (opens new window)
Intel xrdebug-macos-x86_64.pkg (opens new window)
CLI instructions

Run the following to install from your terminal:

# Linux & Windows WSL

Download the .tar.gz file for your CPU architecture and extract it to a directory in your PATH.

CPU Download
aarch64 xrdebug-linux-aarch64.tar.gz (opens new window)
x86_64 xrdebug-linux-x86_64.tar.gz (opens new window)
CLI instructions

Run the following to install from your terminal:


Download latest xrdebug.phar (opens new window) file.

CLI instructions

To download and verify from terminal:

# download
curl -LO https://github.com/xrdebug/xrdebug/releases/latest/download/xrdebug.phar
curl -LO https://github.com/xrdebug/xrdebug/releases/latest/download/xrdebug.phar.asc
# verify
gpg --recv-keys 75BD018B5EB1DAC838C358414B997D0D617BB354
gpg --with-fingerprint --verify xrdebug.phar.asc xrdebug.phar

# Source

To install from source clone the repository (opens new window):

git clone https://github.com/xrdebug/xrdebug.git

Install dependencies using Composer:

composer install

The command will be available at:


# Packagist

Use package xrdebug/xrdebug (opens new window) to install as a dependency for your project using Composer:

composer require --dev xrdebug/xrdebug

The dependency server will be available at:


# Docker

Container images are available at ghcr.io/xrdebug/xrdebug (opens new window).

Run the following command to start the server at port 27420:

docker run -t --init --rm -p 27420:27420 ghcr.io/xrdebug/xrdebug