From d62f46eed4be8998f4aa75e20bd0dca2e453313f Mon Sep 17 00:00:00 2001
From: Hennadii Stepanov <32963518+hebasto@users.noreply.github.com>
Date: Fri, 21 Nov 2025 11:33:07 +0000
Subject: [PATCH] doc: Add `INSTALL.md` to Linux release tarballs

---
 contrib/guix/libexec/build.sh |  1 +
 doc/INSTALL_linux.md          | 29 +++++++++++++++++++++++++++++
 2 files changed, 30 insertions(+)
 create mode 100644 doc/INSTALL_linux.md

diff --git a/contrib/guix/libexec/build.sh b/contrib/guix/libexec/build.sh
index 48301841841..02e7f109caf 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 00000000000..c6bec558feb
--- /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.