From 77b161bd692b0bf407c9164a17eb0c676814aa85 Mon Sep 17 00:00:00 2001
From: "Matt." <4922458+mbrla0@users.noreply.github.com>
Date: Sun, 24 Aug 2025 11:30:45 -0300
Subject: [PATCH] Document removal of quarantine flag during setup of portable
 version for macOS users (#3250)

* Document removal of quarantine flag during setup of portable version for macOS users

* Update setup.md

Co-authored-by: k4lizen <124312252+k4lizen@users.noreply.github.com>

---------

Co-authored-by: k4lizen <124312252+k4lizen@users.noreply.github.com>
---
 docs/setup.md | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/docs/setup.md b/docs/setup.md
index 5a49ba5e7..40debed0a 100644
--- a/docs/setup.md
+++ b/docs/setup.md
@@ -94,5 +94,21 @@ or
 ```
 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:
+
+```{.bash .copy}
+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](contributing/setup-pwndbg-dev.md#installing-pwndbg-from-source), you do not need the "The development environment" section.