4.4 KiB

Raw Blame History

hide

navigation

Setup

There are multiple ways to install Pwndbg, depending on whether you want to use it with GDB, with LLDB, use a portable release, or install it from source.

Installing pwndbg-gdb

Install via curl/sh (Linux/macOS)

curl --proto '=https' --tlsv1.2 -LsSf 'https://install.pwndbg.re' | sh -s -- -t pwndbg-gdb

Install via GNU wget/sh (Linux/macOS)

wget --https-only --secure-protocol=TLSv1_2 -qO- 'https://install.pwndbg.re' | sh -s -- -t pwndbg-gdb

Install via BusyBox wget/sh (Linux/macOS)

wget -qO- 'https://install.pwndbg.re' | sh -s -- -t pwndbg-gdb

Install via Homebrew (macOS)

brew install pwndbg/tap/pwndbg-gdb

Install via the Nix package manager (Linux/macOS)

nix shell github:pwndbg/pwndbg

Official Pwndbg packages

When installing with GDB, you may also download a package to install through your package manager of choice. Download the package from the releases page and pick the appropriate download from the second table.

RPM-based Systems (CentOS/Alma/Rocky/RHEL):

dnf install ./pwndbg-2025.10.20.x86_64.rpm

DEB-based Systems (Debian/Ubuntu/Kali):

apt install ./pwndbg_2025.10.20_amd64.deb

Alpine:

apk add --allow-untrusted ./pwndbg_2025.10.20_x86_64.apk

Arch Linux:

pacman -U ./pwndbg-2025.10.20-1-x86_64.pkg.tar.zst

Distro packages

You may want to install Pwndbg through your distribution's package manager. This installation method is not officially supported because we cannot control the versions of the python dependencies Pwndbg uses in this case. Please use any other installation method when reproducing bug reports (portable package is probably simplest in this case). If a bug reproduces with a distro package but not with any of the supported installation methods, please report it to the package maintainer; if the problem cannot be fixed, let us know and we will add it to a list of known issues below.

=== "Arch" {.bash .copy} sudo pacman -S pwndbg You will also need to source Pwndbg from your ~/.gdbinit. Add this line to the beginning of that file: {.bash .copy} source /usr/share/pwndbg/gdbinit.py Pwndbg will be started every time you invoke gdb now.

=== "Gentoo" {.bash .copy} sudo emerge --ask dev-debug/pwndbg

Installing pwndbg-lldb

These installation methods provide the

pwndbg-lldb ./your-binary

command.

Install via curl/sh (Linux/macOS)

curl --proto '=https' --tlsv1.2 -LsSf 'https://install.pwndbg.re' | sh -s -- -t pwndbg-lldb

Install via Homebrew (macOS)

brew install pwndbg/tap/pwndbg-lldb

Install via the Nix package manager (Linux/macOS):

nix shell github:pwndbg/pwndbg#pwndbg-lldb

Download the Portable Version

You can download a portable release on the Pwndbg releases page. There are seperate releases for GDB and LLDB. Use the first table to pick the appropriate download for your system architecture. You can then unpack the archive with:

tar -v -xf <archive-name>

And run Pwndbg with

./pwndbg/bin/pwndbg

./pwndbg/bin/pwndbg-lldb

depending on which version you installed. You may add the appropriate file to your shell's PATH.

Removing Quarantine Flags (macOS)

When first setting up the portable version of Pwndbg in macOS, Gatekeeper will normally try to prevent any code in the extracted files from running until the user explicitly allows each file to be run. As we ship many files which would require this, the process of manually granting permission for each one to be run can get quite tiresome.

In order to do this to all files at once, you may choose to run the following command, which removes the quarantine flag from all extracted files at once:

xattr -rd com.apple.quarantine pwndbg

Assuming that the files were extracted to a folder called pwndbg.

Installing from source

See contributing/Installing Pwndbg from source, you do not need the "The development environment" section.

4.4 KiB Raw Blame History