From 78ed2dc44f998f5176bbd829ffc66df3a5c749b9 Mon Sep 17 00:00:00 2001
From: Remi Collet <remi@remirepo.net>
Date: Thu, 19 Mar 2026 16:03:13 +0100
Subject: [PATCH 1/2] add installation instructions for RPM packages

---
 docs/usage.md | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/docs/usage.md b/docs/usage.md
index 4bce9b2e..43b59154 100644
--- a/docs/usage.md
+++ b/docs/usage.md
@@ -31,6 +31,19 @@ curl -fL --output /tmp/pie.phar https://github.com/php/pie/releases/latest/downl
   && sudo chmod +x /usr/local/bin/pie
 ```
 
+### Distribution packages
+
+**On Fedora and Enterprise Linux 10**
+
+On Enterprise Linux (CentOS, RHEL, AlmaLinux, RockyLinux, and other clones) you
+need to enable the [EPEL](https://docs.fedoraproject.org/en-US/epel/) repository.
+
+```shell
+sudo dnf install pie
+```
+
+Package information: [pie](https://src.fedoraproject.org/rpms/pie)
+
 ### Docker installation
 
 PIE is published as binary-only Docker image, so you can use it easily during your Docker build:

From 030600b22327da71f20444adccf82821b088185a Mon Sep 17 00:00:00 2001
From: James Titcumb <james@asgrim.com>
Date: Thu, 2 Apr 2026 08:44:50 +0100
Subject: [PATCH 2/2] Added warning about distribution packages and Brew
 instructions

---
 docs/usage.md | 20 +++++++++++++++++++-
 1 file changed, 19 insertions(+), 1 deletion(-)

diff --git a/docs/usage.md b/docs/usage.md
index 43b59154..31deb37c 100644
--- a/docs/usage.md
+++ b/docs/usage.md
@@ -33,17 +33,35 @@ curl -fL --output /tmp/pie.phar https://github.com/php/pie/releases/latest/downl
 
 ### Distribution packages
 
-**On Fedora and Enterprise Linux 10**
+> [!WARNING]
+> Distribution packages are not maintained by PIE, so may not have the latest version, may have patches applied, or
+> the instructions here may be out of date. You should verify the distribution packages before using them.
+
+#### Fedora and Enterprise Linux 10
 
 On Enterprise Linux (CentOS, RHEL, AlmaLinux, RockyLinux, and other clones) you
 need to enable the [EPEL](https://docs.fedoraproject.org/en-US/epel/) repository.
 
 ```shell
 sudo dnf install pie
+
+# If you have `gh`, you can verify PIE is authentic:
+gh attestation verify --owner=php $(which pie)
 ```
 
 Package information: [pie](https://src.fedoraproject.org/rpms/pie)
 
+#### Homebrew
+
+PIE can be installed with Homebrew with:
+
+```shell
+brew install pie
+
+# If you have `gh`, you can verify PIE is authentic:
+gh attestation verify --owner=php $(which pie)
+```
+
 ### Docker installation
 
 PIE is published as binary-only Docker image, so you can use it easily during your Docker build: