How to Run a Bitcoin Full Node on a Raspberry Pi

Before we begin, we need to install Raspberry Pi OS on the Raspberry Pi. Follow the link in this step for detailed instructions on the process.

While you've got your SD card mounted on your laptop, now is a good time to configure WiFi and enable SSH.

Because the entire blockchain is a few hundred gigabytes, you'll need to either get a massive SD card or use an external hard drive. I recommend using an external hard drive as long as the read/write speeds are sufficient. The bitcoin.org documentation recommends a storage device with at least 100 MB/s. I'm using a hard drive with 160 MB/s, but I after having gone through this process, I highly recommend using a 1TB+ SSD (solid-state drive). The initial block download (that we'll cover in more depth later) will take quite a bit of time and using an SSD will make your life easier.

Used here

See all

Samsung T5 1TB Portable SSD

Check Price on Amazon

With the hard drive connected, you can now boot the Raspberry Pi.

If you're using the Raspberry Pi desktop and have a monitor, keyboard, and mouse available, you can go ahead and boot the operating system and log in.

Otherwise, you'll need to connect to the Pi via SSH. We've written a detailed guide on how to connect to your Raspberry Pi via SSH, so please refer to that guide if you need additional help.

In summary, you need to get the IP address of your Raspberry Pi and run the following in a Terminal application:

ssh pi@<ip_address>

Unless you've changed it, the password is "raspberry".

In order to use the hard drive to store blockchain data, you'll need to configure the Pi and mount the drive.

Install the necessary storage drivers

Depending on the hard drive you purchase, you'll need to install the necessary storage driver for the Pi. The storage driver depends on the file system type used on the hard drive.

You can also reformat the hard drive using a different file system type, but that's beyond the scope of this guide.

To find the file system type of your hard drive, you can type:

sudo lsblk -o UUID,NAME,FSTYPE,SIZE,MOUNTPOINT,LABEL

Use the LABEL column to identify your storage device and the FSTYPE column to find the file system type.

ntfs

For ntfs devices, use:

sudo apt-get update
sudo apt install ntfs-3g

exFAT

For exFAT, use:

sudo apt-get update
sudo apt install exfat-fuse

Mount the drive

Get the disk partition location

Next, you'll need to mount the storage device onto your Raspberry Pi. First, get the location of the disk partition we want to mount using:

sudo blkid

Again, look for the label and copy the first column. It's often something like /dev/sda1 or /dev/sda2. Mine is /dev/sda2.

Create the mount point and mount the disk

It's customary (but not required) to put disk mounts in /mnt. Because the device will hold Bitcoin data, we'll name the mount point "bitcoin".

sudo mkdir /mnt/bitcoin
sudo mount /dev/sda2 /mnt/bitcoin

Verify the disk was mounted properly

To verify that the disk was mounted correctly, run:

df -h

You should see something like the following:

Filesystem      Size  Used Avail Use% Mounted on
/dev/root        30G  3.0G   25G  11% /
...
/dev/sda2       7.3T  320M  7.3T   1% /mnt/bitcoin

Set up automatic mounts

So far, you've mounted the external hard drive manually, but the next time you boot the machine you'll have to do it again. Fortunately, we can automatically mount the device each time we boot using fstab.

To do this, we'll need to get the PARTUUID. To get this value, run:

sudo blkid

Again, find the device by the LABEL and take note of the PARTUUID.

Now open /etc/fstab to edit, and append the following line:

PARTUUID=<part uuid> <mount point> <fs type> defaults,auto,users,rw,nofail 0 0

Replace <part uuid>, <mount point>, and <fs type> with the correct values. If the fstype is ntfs or fat, add ,umask=000 immediately after nofail.

For example, mine is:

PARTUUID=31324ddc-391f-488f-97db-48a108edfe04 /mnt/bitcoin ntfs defaults,auto,users,rw,nofail,umask=000 0 0

Now it's time to download and install bitcoind. To do so, go to the bitcoin downloads page and find the option to download Bitcoin Core for ARM Linux. Right click, and copy the link URL.

Back in your shell session on your Raspberry Pi, type:

wget https://bitcoin.org/bin/bitcoin-core-0.20.1/bitcoin-0.20.1-arm-linux-gnueabihf.tar.gz

Use the URL you just copied.

Now install bitcoind.

tar xvf bitcoin-0.20.1-arm-linux-gnueabihf.tar.gz
sudo install -m 0755 -o root -g root -t /usr/local/bin bitcoin-0.20.1/bin/*

That's it! You should be able to see output with the following commands:

bitcoind --help
bitcoin-cli --help

At this point, if you're using the Raspberry Pi OS Desktop and would prefer to use a GUI, you can skip this step and follow the instructions found here.

With the external hard drive configured and bitcoind installed, you can now run the bitcoind daemon. Using the following command will start the bitcoind daemon specifying our external hard drive as the data directory.

bitcoind -daemon --datadir=/mnt/bitcoin

If everything is successful, you should see the following output:

Bitcoin Core starting

A note on the data directory

Since we're starting the daemon with a non-standard data directory, we'll need to specify the datadir every time we use the bitcoin-cli command, like this:

bitcoin-cli -datadir=/mnt/bitcoin

However, if you want to avoid this, you can simply add an alias in your bashrc file. Open ~/.bashrc and append the following:

alias bitcoin-cli='bitcoin-cli -datadir=/mnt/bitcoin'

Save the file, then run:

source ~/.bashrc

What is happening?

The daemon will take some time to start up, but once it does your node will begin to download the entire Bitcoin blockchain.

The entire blockchain is just under 300GB at the moment, so you can imagine that this will take some time. If you need to pause for whatever reason, you can simply run:

bitcoin-cli stop

This will pause everything. When you start up the daemon again, it will pick up where it left off.

In the previous step, you manually started the daemon. But if you're using the Raspberry Pi as a dedicated Bitcoin full node, you'll likely want the daemon to start whenever the machine boots.

To do so, edit your crontab by running the following command:

crontab -e

And append the following:

@reboot /usr/local/bin/bitcoind -daemon --datadir=/mnt/bitcoin

Save the file and exit. Now the bitcoin daemon will start whenever your system boots.

Assuming you're using your full node to support the Bitcoin network, you'll need to make sure your node accepts inbound connections.

You can test inbound connections by visiting https://bitnodes.io/#join-the-network. Enter your IP address and the port, if you happened to modify it (the default port is 8333).

Chances are you're running your full node on your home network, which means you likely saw an error in the previous step. To resolve this, you'll need to forward port 8333 from your WiFi router to your Raspberry Pi.

Every router is different, so you may have to do some digging around. Fortunately, we've written a guide on how to open a port on your router that should give you some direction.

After you've set up port forwarding, test your connection again using the instructions from the previous step.

When you spin up your full node for the first time, your node will have no knowledge of the existing blockchain history. So the very first thing it needs to do is sync with the rest of the network by downloading and verifying all blocks. This is a very time and resource consuming operation because it needs to download and verify over 340Gb of data (at the time I'm writing this).

So in this step I'll provide a few optional suggestions for speeding up the initial block download.

Use an SSD

As I mentioned previously, I opted for an 8TB HDD but should've gone with a 1TB SSD at a similar price. Read/write speeds are much faster on the SSD, so this is the best way to eliminate a potential bottleneck on disk IO.

Use a more powerful computer to do the initial download

While doing the initial block download on my Raspberry Pi, I noticed that it was CPU constrained the entire time. So to speed things up, I opted to spin up a powerful, compute-optimized virtual machine on GCE. If you're curious, I used a c2-standard-8, which comes with 8 CPUs and 32GB of memory. I attached a 500GB SSD and a 500GB HDD (I would've just used a 1TB SSD, but I needed to get a quota lifted first). The entire blockchain was downloaded and verified within 12 hours.

If you'd like to use this method, be warned that you'll still need to transfer the entire blocks and chainstate directories from the virtual machine to your Pi, replacing the existing directories.

If using a high-power virtual machine on GCP or AWS isn't an option, you can try any other more powerful desktop or laptop you have available.

Downloading the blockchain will take a LONG time. Check your ISP account and make sure you have enough data available on your plan; otherwise, you might get throttled or shut down. Once the blockchain downloads, you'll be in business.

bitcoin-cli

Take some time to learn the bitcoin-cli. You can start by listing all of the commands:

bitcoin-cli help

Use your wallet

If you'd like, you can use the wallet on your full node to store Bitcoin. In reality, this isn't the most convenient or safe way to store Bitcoin, as it's hard to use and connected to the Internet at all times.