doc: Add `INSTALL.md` to Linux release tarballs
What changed, and why it matters
This change only adds an installation instruction file to Linux release packages. It does not modify any executable code, network behavior, or security-sensitive logic.
No security action required. This is a documentation-only packaging improvement.
Security signals we found
No strong security signals were identified.
Evidence from the diff
The commit adds doc/INSTALL_linux.md and updates contrib/guix/libexec/build.sh to copy it into Linux release tarballs as INSTALL.md. The document describes runtime dependencies such as glibc version requirements and Qt GUI library dependencies. There are no code changes affecting consensus, networking, wallet, or build integrity.
Changed components
contrib/guix/libexec/build.shdoc/INSTALL_linux.mdInspect captured patch +30 / −0
diff --git a/contrib/guix/libexec/build.sh b/contrib/guix/libexec/build.sh
index 48301841..02e7f109 100755
--- a/contrib/guix/libexec/build.sh
+++ b/contrib/guix/libexec/build.sh
@@ -309,6 +309,7 @@ mkdir -p "$DISTSRC"
;;
*linux*)
cp "${DISTSRC}/README.md" "${DISTNAME}/"
+ cp "${DISTSRC}/doc/INSTALL_linux.md" "${DISTNAME}/INSTALL.md"
;;
esac
diff --git a/doc/INSTALL_linux.md b/doc/INSTALL_linux.md
new file mode 100644
index 00000000..c6bec558
--- /dev/null
+++ b/doc/INSTALL_linux.md
@@ -0,0 +1,29 @@
+Bitcoin Core
+=============
+
+Below are notes on installing Bitcoin Core software on Linux systems.
+
+General Runtime Requirements
+----------------------------
+
+Bitcoin Core requires glibc (GNU C Library) 2.31 or newer.
+
+GUI Runtime Requirements
+------------------------
+
+The GUI executable, `bitcoin-qt`, is based on the Qt 6 framework and uses the `xcb` QPA (Qt Platform Abstraction) platform plugin
+to run on X11. Its runtime library dependencies are as follows:
+- `libfontconfig`
+- `libfreetype`
+
+On Debian, Ubuntu, or their derivatives, you can run the following command to ensure all dependencies are installed:
+```sh
+sudo apt install libfontconfig1 libfreetype6
+```
+
+On Fedora, run:
+```sh
+sudo dnf install fontconfig freetype
+```
+
+For other systems, please consult their documentation.
Why this scored 15/100
Community notes
Notes can correct, qualify, or add evidence to the AI analysis. Every note shown here has been validated by a human moderator.
The AI analysis stands alone for now. Submit a note if you can add evidence or important context.