Files
bitcoin/doc
Ava Chow a846a7c805 Merge bitcoin/bitcoin#34811: doc: update cjdns.md for current cjdns installation and peering
6b99a3e4f0 doc: update cjdns.md for current upstream changes (w0xlt)

Pull request description:

  Update `doc/cjdns.md`. Users following the current doc hit dead links when trying to set up cjdns peering. The upstream cjdns project has reorganized its README and now supports automatic peering, making most of the existing instructions obsolete.

  Summary

  * Remove broken links to cjdns README sections ("2. Find a friend", "3. Connect your node to your friend's node") that no longer exist upstream

  * Remove reference to `hyperboria/peers` repo and `testAvailable.py` (last updated Feb 2024, likely stale)

  * Add `cjdns.sh` as recommended install method alongside building from source

  * Document automatic peering via DNS seeding (default since cjdns v22), which makes manual peer discovery unnecessary for most users

  * Simplify manual peering instructions with a clear `connectTo` example and link to upstream `doc/peering.md`

  * Add `cjdnstool peers show` as the way to verify network connectivity

  The Bitcoin Core-specific sections (`-cjdnsreachable`, `-onlynet=cjdns`, admin commands, etc.) are unchanged.

ACKs for top commit:
  achow101:
    ACK 6b99a3e4f0
  stratospher:
    ACK 6b99a3e. worked on nixos.
  brunoerg:
    reACK 6b99a3e4f0
  naiyoma:
    TestedACK 6b99a3e4f0

Tree-SHA512: 00a703a788e96af4fd9456246644c3047b1d5cbed41d97f4f4f64f60b34cd6ffbf052d5e8f32365e65fd09a44fd0e16dd0dd45f6c75563f18075414f9b3eb1e7
2026-03-30 14:00:10 -07:00
..
2026-03-06 13:10:30 -08:00
2026-03-10 14:13:44 +00:00
2026-02-27 17:15:07 +01:00
2026-02-27 17:15:07 +01:00
2026-03-02 22:33:10 +00:00
2026-03-24 15:51:24 +01:00

Bitcoin Core

Setup

Bitcoin Core is the original Bitcoin client and it builds the backbone of the network. It downloads and, by default, stores the entire history of Bitcoin transactions, which requires several hundred gigabytes or more of disk space. Depending on the speed of your computer and network connection, the synchronization process can take anywhere from a few hours to several days or more.

To download Bitcoin Core, visit bitcoincore.org.

Running

The following are some helpful notes on how to run Bitcoin Core on your native platform.

Unix

Unpack the files into a directory and run:

  • bin/bitcoin-qt (GUI) or
  • bin/bitcoind (headless)
  • bin/bitcoin (wrapper command)

The bitcoin command supports subcommands like bitcoin gui, bitcoin node, and bitcoin rpc exposing different functionality. Subcommands can be listed with bitcoin help.

Windows

Unpack the files into a directory, and then run bitcoin-qt.exe.

macOS

Drag Bitcoin Core to your applications folder, and then run Bitcoin Core.

Need Help?

Building

The following are developer notes on how to build Bitcoin Core on your native platform. They are not complete guides, but include notes on the necessary libraries, compile flags, etc.

Development

The Bitcoin repo's root README contains relevant information on the development process and automated testing.

Resources

Miscellaneous

License

Distributed under the MIT software license.