Marlon's Wiki

it's better when it's simpler

User Tools

Site Tools


start:system:bitcoin:node

This is an old revision of the document!


Bitcoin Node

In the “Linux (tgz)” section of the Download page, choose the appropriate file for your Linux install (either 32-bit or 64-bit) and download the file. If necessary, move the file to the computer you want to use to run Bitcoin Core.

tar xzf bitcoin-27.0-x86_64-linux-gnu.tar.gz

This will create the directory bitcoin-27.0 within your current working directory. We will install the contents of its bin subdirectory into the /usr/local/bin directory using the the install command. The install command is part of the GNU coreutils available on nearly every Linux distribution, and the /usr/local/bin directory is a standard location for self-installed executables (you may edit the commands below to use a different location).

If you use sudo to run commands as root, use the following command line:

<code> sudo install -m 0755 -o root -g root -t /usr/local/bin bitcoin-27.0/bin/*

If you use su to run commands as root, use the following command line:

su -c 'install -m 0755 -o root -g root -t /usr/local/bin bitcoin-27.0/bin/*'

To continue, choose one of the following options

  To use Bitcoin Core Graphical User Interface (GUI), proceed to the Bitcoin Core GUI section below.
  To use the Bitcoin Core daemon (bitcoind), which is useful for programmers and advanced users, proceed to the Bitcoin Core Daemon section below.
  To use both the GUI and the daemon, read both the GUI instructions and the daemon instructions. Note that you can’t run both the GUI and the daemon at the same time using the same configuration directory.

Optional: Start Your Node At Login

Starting your node automatically each time you login to your computer makes it easy for you to contribute to the network. The easiest way to do this is to tell Bitcoin Core GUI to start at login. This only works in desktop environments that support the autostart specification, such as Gnome, KDE, and Unity.

While running Bitcoin Core GUI, open the Settings menu and choose Options. On the Main tab, click Start Bitcoin on system login. Click the Ok button to save the new settings.

Choosing to start Bitcoin Core at login

The next time you login to your desktop, Bitcoin Core GUI should be automatically started as an icon in the tray.

Bitcoin-Qt Tray Icon

If Bitcoin Core GUI does not automatically start, you may need to add it to an .xinit or .xsession file as described here.

You have now completed installing Bitcoin Core. If you have any questions, please ask in one of Bitcoin’s many communities, such as Bitcoin StackExchange, BitcoinTalk technical support, or the #bitcoin IRC chatroom on Freenode.

To support the Bitcoin network, you also need to allow incoming connections. Please read the Network Configuration section for details. Bitcoin Core Daemon

If you’re logged in as an administrative user with sudo access, you may log out. The steps in this section should be performed as the user you want to run Bitcoin Core. (This can be a locked account used only by Bitcoin Core.) If you changed users in a graphical interface, start a terminal.

Type the following command:

bitcoind -daemon

It will print a message that Bitcoin Core is starting. To interact with Bitcoin Core daemon, you will use the command bitcoin-cli (Bitcoin command line interface).

Note: it may take up to several minutes for Bitcoin Core to start, during which it will display the following message whenever you use bitcoin-cli:

error: {“code”:-28,“message”:“Verifying blocks…”}

After it starts, you may find the following commands useful for basic interaction with your node: getblockchaininfo, getnetworkinfo, getnettotals, getwalletinfo, stop, and help.

For example, to safely stop your node, run the following command:

bitcoin-cli stop

A complete list of commands is available in the Bitcoin.org developer reference.

When Bitcoin Core daemon first starts, it will begin to download the block chain. This step will take at least several days, and it may take much more time on a slow Internet connection or with a slow computer. During the download, Bitcoin Core will use a significant part of your connection bandwidth. You can stop Bitcoin Core at any time using the stop command; it will resume from the point where it stopped the next time you start it.

Start Your Node At Boot

Starting your node automatically each time your computer boots makes it easy for you to contribute to the network. The easiest way to do this is to start Bitcoin Core daemon from your crontab. To edit your crontab on most distributions, run the following command:

crontab -e

Scroll to the bottom of the file displayed and add the following line:

start/system/bitcoin/node.1735981744.txt.gz · Last modified: 2025/01/04 09:09 by marlonivo

Donate Marlon Ivo's Webpage