Merge bitcoin/bitcoin#33451: doc: Add INSTALL.md to Linux release tarballs

d62f46eed4be8998f4aa75e20bd0dca2e453313f doc: Add `INSTALL.md` to Linux release tarballs (Hennadii Stepanov)

Pull request description:

  Closes https://github.com/bitcoin/bitcoin/issues/32097:
  > Better I think would be to add instructions for the most popular desktop distros.

ACKs for top commit:
  willcl-ark:
    utACK d62f46eed4be8998f4aa75e20bd0dca2e453313f
  achow101:
    ACK d62f46eed4be8998f4aa75e20bd0dca2e453313f
  janb84:
    re ACK d62f46eed4be8998f4aa75e20bd0dca2e453313f
  w0xlt:
    ACK d62f46eed4be8998f4aa75e20bd0dca2e453313f
  sedited:
    ACK d62f46eed4be8998f4aa75e20bd0dca2e453313f

Tree-SHA512: eab6904b6acc63eaf0e13112f52d856ee630ce4110fb368f4f5f170655def91706bb7c7f70c123186a51461ea3d48ef026a4e026d665675f1fd76f2d0bbca68c
This commit is contained in:
Ava Chow 2026-03-13 13:20:04 -07:00
commit 16a02bf5af
No known key found for this signature in database
GPG Key ID: 17565732E08E5E41
2 changed files with 30 additions and 0 deletions

View File

@ -309,6 +309,7 @@ mkdir -p "$DISTSRC"
;;
*linux*)
cp "${DISTSRC}/README.md" "${DISTNAME}/"
cp "${DISTSRC}/doc/INSTALL_linux.md" "${DISTNAME}/INSTALL.md"
;;
esac

29
doc/INSTALL_linux.md Normal file
View File

@ -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.