mirror of https://github.com/pwndbg/pwndbg.git
You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
81 lines
2.4 KiB
Markdown
81 lines
2.4 KiB
Markdown
---
|
|
hide:
|
|
- navigation
|
|
---
|
|
|
|
# Setup
|
|
|
|
There are multiple ways to install pwndbg, depending on whether you want to use it [with GDB](#installing-pwndbg-gdb), [with LLDB](#installing-pwndbg-lldb), use a [portable release](#download-the-portable-version), or install it [from source](#installing-from-source).
|
|
|
|
## Installing pwndbg-gdb
|
|
Install via curl/sh (Linux/macOS)
|
|
```{.bash .copy}
|
|
curl -qsL 'https://install.pwndbg.re' | sh -s -- -t pwndbg-gdb
|
|
```
|
|
Install via Homebrew (macOS)
|
|
```{.bash .copy}
|
|
brew install pwndbg/tap/pwndbg-gdb
|
|
```
|
|
Install via the Nix package manager (Linux/macOS)
|
|
```{.bash .copy}
|
|
nix shell github:pwndbg/pwndbg
|
|
```
|
|
### Through package manager
|
|
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](https://github.com/pwndbg/pwndbg/releases) and pick the appropriate download from the second table.
|
|
|
|
|
|
RPM-based Systems (CentOS/Alma/Rocky/RHEL):
|
|
```{.bash .copy}
|
|
dnf install ./pwndbg-2025.04.18.x86_64.rpm
|
|
```
|
|
DEB-based Systems (Debian/Ubuntu/Kali):
|
|
```{.bash .copy}
|
|
apt install ./pwndbg_2025.04.18_amd64.deb
|
|
```
|
|
Alpine:
|
|
```{.bash .copy}
|
|
apk add --allow-untrusted ./pwndbg_2025.04.18_x86_64.apk
|
|
```
|
|
Arch Linux:
|
|
```{.bash .copy}
|
|
pacman -U ./pwndbg-2025.04.18-1-x86_64.pkg.tar.zst
|
|
```
|
|
|
|
## Installing pwndbg-lldb
|
|
These installation methods provide the
|
|
```{.bash .copy}
|
|
pwndbg-lldb ./your-binary
|
|
```
|
|
command.
|
|
|
|
Install via curl/sh (Linux/macOS)
|
|
```{.bash .copy}
|
|
curl -qsL 'https://install.pwndbg.re' | sh -s -- -t pwndbg-lldb
|
|
```
|
|
Install via Homebrew (macOS)
|
|
```{.bash .copy}
|
|
brew install pwndbg/tap/pwndbg-lldb
|
|
```
|
|
Install via the Nix package manager (Linux/macOS):
|
|
```{.bash .copy}
|
|
nix shell github:pwndbg/pwndbg#pwndbg-lldb
|
|
```
|
|
|
|
## Download the Portable Version
|
|
You can download a portable release on the [pwndbg releases page](https://github.com/pwndbg/pwndbg/releases). 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:
|
|
```{.bash .copy}
|
|
tar -v -xf <archive-name>
|
|
```
|
|
And run pwndbg with
|
|
```bash
|
|
./pwndbg/bin/pwndbg
|
|
```
|
|
or
|
|
```
|
|
./pwndbg/bin/pwndbg-lldb
|
|
```
|
|
depending on which version you installed. You may add the appropriate file to your shell's PATH.
|
|
|
|
## Installing from source
|
|
See [contributing/Installing pwndbg from source](contributing/1-setup-pwndbg-dev.md#installing-pwndbg-from-source), you do not need the "The development environment" section.
|