CI: Improve documentation around replicating CI locally #31199

1. 
   m3dwards commented at 8:03 pm on October 31, 2024: contributor

   I’ve received some feedback that replicating CI jobs locally isn’t straightforward. Perhaps the documentation can be improved in this area? @maflcko I understand you had some improvements in mind? Happy to also work on this.
2. maflcko added the label Brainstorming on Nov 1, 2024
3. maflcko added the label Docs on Nov 1, 2024
4. maflcko added the label Build system on Nov 1, 2024
5. maflcko added the label Tests on Nov 1, 2024
6. 
   maflcko commented at 7:33 am on November 1, 2024: member

   Yeah, this keeps coming up (ex: #31144 (comment)), but I don’t know how to improve the docs.

   Another related idea was to move the CC/CXX/SANITZER/… build options into a cmake preset, which could make it easier to reproduce some CI failures. Ref: https://bitcoin-irc.chaincode.com/bitcoin-core-dev/2024-09-05#1050658 and some more discussion in #30871 (comment)

7. 
   maflcko commented at 7:09 am on December 9, 2024: member

   In the docs, it could be clearer to explain why env may be needed: #31176 (comment)
8. 
   maflcko commented at 9:02 am on January 20, 2025: member

   Also, setup of qemu is missing: #31657 (comment)
9. willcl-ark assigned hodlinator on Oct 21, 2025
10. 
    hodlinator commented at 2:09 pm on November 17, 2025: contributor

    PR is live: #33887
11. 
    maflcko commented at 2:23 pm on November 17, 2025: member

    Another related idea was to move the CC/CXX/SANITZER/… build options into a cmake preset, which could make it easier to reproduce some CI failures. Ref: https://bitcoin-irc.chaincode.com/bitcoin-core-dev/2024-09-05#1050658 and some more discussion in #30871 (comment)

    this was moved to dev-mode in #33824, so maybe this is already a step in the right direction?

12. fanquake closed this on Nov 20, 2025

    ---

13. fanquake reopened this on Nov 20, 2025

    ---

14. 
    fanquake commented at 5:23 pm on November 20, 2025: member

    @m3dwards can you advise if this can be closed after #33887. Or clarify in the description what else should be done.
15. hebasto referenced this in commit 6cdb51c14e on Nov 20, 2025
16. 
    maflcko commented at 5:46 pm on November 20, 2025: member

    Yeah, I think this can be closed for now, but I’d be excited to see new issues, if there are still questions or hard CI edges. Also, happy to review more pull requests around CI docs.
17. fanquake closed this on Nov 20, 2025

    ---

Contributors
m3dwards maflcko hodlinator fanquake

Labels
Brainstorming Docs Build system Tests