diff --git a/contrib/guix/libexec/build.sh b/contrib/guix/libexec/build.sh index 072e5b91ba6..38f3958eb24 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.