# Installation

# Self-contained binary recommended

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

# macOS

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

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:

# PHAR

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:

./xrdebug

# 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:

vendor/bin/xrdebug

# 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