From 7d76235dfc6bb7a3860ebd2db01e4467292d2704 Mon Sep 17 00:00:00 2001
From: Neil <4138956+nwparker@users.noreply.github.com>
Date: Mon, 31 Aug 2026 03:10:13 -0700
Subject: [PATCH] docs(linux): document local RPM build prerequisites

---
 docs/reference/linux-glibc-compatibility.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/docs/reference/linux-glibc-compatibility.md b/docs/reference/linux-glibc-compatibility.md
index a11506235fe..20e9b38acb5 100644
--- a/docs/reference/linux-glibc-compatibility.md
+++ b/docs/reference/linux-glibc-compatibility.md
@@ -6,6 +6,14 @@ Packaging enforces this floor automatically; keep it in mind when adding or
 upgrading native dependencies. (The optional speech feature is the one
 exception — see below.)
 
+## Local package build prerequisites
+
+`pnpm run build:linux` produces AppImage, deb, and RPM artifacts. The RPM target
+requires `rpmbuild` on `PATH`; install `rpm` on Ubuntu/Debian, `rpm-build` on
+Fedora/RHEL, or `rpm` through Homebrew on macOS, then verify it with
+`rpmbuild --version` before packaging. Cross-host builds have the same
+requirement.
+
 ## Why this needs attention
 
 A native module (`.node`) links against the glibc of the machine that compiled