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

1. 
   hebasto commented at 7:32 pm on September 21, 2025: member

   Closes #32097:

   Better I think would be to add instructions for the most popular desktop distros.

2. hebasto added the label Docs on Sep 21, 2025
3. 
   DrahtBot commented at 7:32 pm on September 21, 2025: contributor

   The following sections might be updated with supplementary metadata relevant to reviewers and maintainers.

   Code Coverage & Benchmarks

   For details see: https://corecheck.dev/bitcoin/bitcoin/pulls/33451.

   Reviews

   See the guideline for information on the review process.

   Type	Reviewers
   ACK	janb84, achow101

   If your review is incorrectly listed, please react with 👎 to this comment and the bot will ignore it on the next update.

4. hebasto added this to the milestone 30.0 on Sep 21, 2025
5. 
   janb84 commented at 1:57 pm on September 25, 2025: contributor

   ACK fc6d41d078656024cf9b3a8ef30b6cd2c79cfcf6

   PR adds installation documentation for linux. The installation manual has an easy to copy section for installation of the QT dependencies.

   Tested on clean Debian 13 install:

   • KDE already has all the dependencies installed, works out of the box. Installing the suggested dependencies results in 0 new installs.
   • XFCE is missing libxcb-cursor and the manual works as a charm in supplying that dependency.

   Tested with binary version V30.0rc1

6. doc: Add `INSTALL.md` to Linux release tarballs 0fe7d552ab
7. in doc/INSTALL_linux.md:19 in fc6d41d078

   14+The GUI executable, `bitcoin-qt`, is based on the Qt 6 framework and uses the `xcb` QPA (Qt Platform Abstraction) platform plugin
   15+to run on X11. Its runtime library [dependencies](https://doc.qt.io/archives/qt-6.7/linux-requirements.html) are as follows:
   16+- `libfontconfig`
   17+- `libfreetype`
   18+- `libxcb`
   19+- `libxcb-cursor`
   

   ---

   ---

   

   fanquake commented at 3:20 pm on October 3, 2025:

   libxcb-cursor can be removed now.

   ---

   

   hebasto commented at 4:40 pm on October 4, 2025:

   Removed.
8. hebasto force-pushed on Oct 4, 2025
9. 
   hebasto commented at 4:40 pm on October 4, 2025: member

   Feedback from @fanquake has been addressed.
10. 
    janb84 commented at 8:26 am on October 6, 2025: contributor

    Feedback from @fanquake has been addressed.

    I re-tested this but without libxcb-cursor I cannot start bitcoin-qt on Xcfe / Debian 13

    0./bitcoin-qt 
    1./bitcoin-qt: error while loading shared libraries: libxcb-cursor.so.0: cannot open shared object file: No such file or directory
    

    edit: Tested this on a pre-compiled bin V30rc2.

11. 
    willcl-ark commented at 8:29 am on October 6, 2025: member

    @janb84 you’ll need to guix build a binary from a commit post #33434 (or for v30 with #33473 checked out)
12. 
    janb84 commented at 9:16 am on October 6, 2025: contributor

    (re) ACK 0fe7d552ab213065b8d5807c3dd9f4e976717529

    retested on Debian 13 / Xfce with recent guix build of master (a33bd767a37d) (No need for libxcb-cursor anymore)

13. 
    achow101 commented at 8:09 pm on October 7, 2025: member

    ACK 0fe7d552ab213065b8d5807c3dd9f4e976717529

     055ee7f209c6cd5592a87472cacaf873e4a108f681465c238b66792a422306a15  guix-build-0fe7d552ab21/output/aarch64-linux-gnu/SHA256SUMS.part
     1eac376bc61d39740e37283df30c04ed330d1fe2ecc66ae2fb87e484c9f5589e1  guix-build-0fe7d552ab21/output/aarch64-linux-gnu/bitcoin-0fe7d552ab21-aarch64-linux-gnu-debug.tar.gz
     27a31fb9bccf15dbb439f5a1600597188d8d97f4f0f9b94ccdf78bd1e90621421  guix-build-0fe7d552ab21/output/aarch64-linux-gnu/bitcoin-0fe7d552ab21-aarch64-linux-gnu.tar.gz
     30ffbbdcaa274036ca21c20fed7ab6e638a824d2b474485fbab171a01c5da6066  guix-build-0fe7d552ab21/output/arm-linux-gnueabihf/SHA256SUMS.part
     4d7f86fb058ae62b788b6e555313bad68f44bb00210cf53433d1f0657560756ef  guix-build-0fe7d552ab21/output/arm-linux-gnueabihf/bitcoin-0fe7d552ab21-arm-linux-gnueabihf-debug.tar.gz
     5b00804cc7762bfa2cda2f689d04f86bcc6e8b2bb987a78404b8c8f38d5fe364e  guix-build-0fe7d552ab21/output/arm-linux-gnueabihf/bitcoin-0fe7d552ab21-arm-linux-gnueabihf.tar.gz
     6759612c7a3e8ab4b64e80b81a4c3d30ac5d54b6874a5d0bb802ce391df732ab2  guix-build-0fe7d552ab21/output/arm64-apple-darwin/SHA256SUMS.part
     7786f0d2f9818a7d8d9864208862fb53ae4564030b8331c10f5302538f45c4cd5  guix-build-0fe7d552ab21/output/arm64-apple-darwin/bitcoin-0fe7d552ab21-arm64-apple-darwin-codesigning.tar.gz
     8f20fa6b4da7a54d46f2047c92f52c6499dda860f3c418891a0ae39564ec78dfb  guix-build-0fe7d552ab21/output/arm64-apple-darwin/bitcoin-0fe7d552ab21-arm64-apple-darwin-unsigned.tar.gz
     9fcfe06a717da1ef1c7ad76f9b658a0ad7bf30f0d93e73a27226042259d662c30  guix-build-0fe7d552ab21/output/arm64-apple-darwin/bitcoin-0fe7d552ab21-arm64-apple-darwin-unsigned.zip
    103bef7fec718e80e5884c563c98f38f8a36a089f130c60d019e36d669c8d4318c  guix-build-0fe7d552ab21/output/dist-archive/bitcoin-0fe7d552ab21.tar.gz
    11887855504cf7c36aeb04ab2844384fb15c26ddaf3928678b98a3ee5307575699  guix-build-0fe7d552ab21/output/powerpc64-linux-gnu/SHA256SUMS.part
    120e6d33ed34549962cdf27df9bc6cfd3adc871bf469d6a29e1e3ede9800e7741d  guix-build-0fe7d552ab21/output/powerpc64-linux-gnu/bitcoin-0fe7d552ab21-powerpc64-linux-gnu-debug.tar.gz
    132e3a91f09fe239f85a6bd86ead685a594ac4fc70f7a24f7c0b3ed5ed530ac6f7  guix-build-0fe7d552ab21/output/powerpc64-linux-gnu/bitcoin-0fe7d552ab21-powerpc64-linux-gnu.tar.gz
    14073a825d9fb32c5a4057777363fc6f04f092838943ea97c4189901742b661b2a  guix-build-0fe7d552ab21/output/riscv64-linux-gnu/SHA256SUMS.part
    15389314fbf4278edb7ce290b35db97e7b69394f9a1bdd7d6f37168ff0011382bb  guix-build-0fe7d552ab21/output/riscv64-linux-gnu/bitcoin-0fe7d552ab21-riscv64-linux-gnu-debug.tar.gz
    16673e69dbb2ac9a3c24944ec413735ad4ce4bab51af8517a99b1b571f8d17faef  guix-build-0fe7d552ab21/output/riscv64-linux-gnu/bitcoin-0fe7d552ab21-riscv64-linux-gnu.tar.gz
    170049242872ac82dcc4efc69306804f501065f19d5b62fd9a24a4cbf7dcf67c68  guix-build-0fe7d552ab21/output/x86_64-apple-darwin/SHA256SUMS.part
    1860809178febc0f192a13f01281d9635ae6406ddc177c294e9e9405908308bb39  guix-build-0fe7d552ab21/output/x86_64-apple-darwin/bitcoin-0fe7d552ab21-x86_64-apple-darwin-codesigning.tar.gz
    19b4999771e3826a0e31696ad46409fd9907f912df03677b6da39cc57e2230c005  guix-build-0fe7d552ab21/output/x86_64-apple-darwin/bitcoin-0fe7d552ab21-x86_64-apple-darwin-unsigned.tar.gz
    203ed7941101e6b307e34e08ee99f4b0d25d79e1825dd84e900073bf339d12f6ed  guix-build-0fe7d552ab21/output/x86_64-apple-darwin/bitcoin-0fe7d552ab21-x86_64-apple-darwin-unsigned.zip
    2120d51d8bfe9860f2d424f0ca4a737aba9a3fc92d11deab2cf8511c017baf9010  guix-build-0fe7d552ab21/output/x86_64-linux-gnu/SHA256SUMS.part
    22f3634f13cebc586f7da622231fa33c9c84fec1d445d4a36b37acb4eec7f61082  guix-build-0fe7d552ab21/output/x86_64-linux-gnu/bitcoin-0fe7d552ab21-x86_64-linux-gnu-debug.tar.gz
    2345cb7190ba16e204bd7f13b9e47b0db213e868e3e03d8f9ab45c75e66496b834  guix-build-0fe7d552ab21/output/x86_64-linux-gnu/bitcoin-0fe7d552ab21-x86_64-linux-gnu.tar.gz
    24fd14f20caa86aa52fb0240c9495e518e169eb9cba3a2700cae00b72cf0e980a2  guix-build-0fe7d552ab21/output/x86_64-w64-mingw32/SHA256SUMS.part
    259d60ebe3d561bb46ba20f152104face77c63ec8c690c2d8b945cb70bdf6a9581  guix-build-0fe7d552ab21/output/x86_64-w64-mingw32/bitcoin-0fe7d552ab21-win64-codesigning.tar.gz
    26c6fb15b7e2607c9451dbffb4a9c256a451b9c1abaf04f5706ecaef995312a5bc  guix-build-0fe7d552ab21/output/x86_64-w64-mingw32/bitcoin-0fe7d552ab21-win64-debug.zip
    27fb868135b8019d8a5ff3837a9e49ed2210c859147f8d254bdd5258cf3f2a27a2  guix-build-0fe7d552ab21/output/x86_64-w64-mingw32/bitcoin-0fe7d552ab21-win64-setup-unsigned.exe
    28d285deabf9d152a690320fed89b7a5d38a2f237b4bdf4bf9697f7b7f750c28b0  guix-build-0fe7d552ab21/output/x86_64-w64-mingw32/bitcoin-0fe7d552ab21-win64-unsigned.zip
    

14. fanquake removed this from the milestone 30.0 on Oct 13, 2025
15. hebasto added this to the milestone 30.1 on Oct 16, 2025

Contributors
hebasto DrahtBot janb84 fanquake willcl-ark achow101

Labels
Docs

Milestone
30.1