System configuration

You are now on the command line of your own Bitcoin node. Let’s start with the configuration.

Table of contents

  1. Create a new connection
  2. System update
  3. Check USB3 drive performance
  4. Data directory
  5. Increase swap file size

Create a new connection

We will use the primary user “admin” which we already configured in the Raspberry Pi Imager (see Configure boot options section).

  • Log in again using SSH (see Access with Secure Shell section), with user “admin” and your password [A]

    $ ssh admin@raspibolt.local
  • You can exit your session any time with

    $ exit

To change the system configuration and files that don’t belong to user “admin”, you have to prefix commands with sudo. You will be prompted to enter your admin password from time to time for increased security.

System update

It is important to keep the system up-to-date with security patches and application updates. The “Advanced Packaging Tool” (apt) makes this easy.

  • Instruct your shell to always use the default language settings. This prevents annoying error messages.

    $ echo "export LC_ALL=C" >> ~/.bashrc
    $ source ~/.bashrc
  • Update the operating system and all installed software packages

    $ sudo apt update
    $ sudo apt full-upgrade

    💡 Do this regularly every few months to get security-related updates.

  • Make sure that all necessary software packages are installed:

    $ sudo apt install git

Check USB3 drive performance

A performant USB3 drive is essential for your node. The Raspberry Pi 4 supports these out of the box, but is a bit picky. Some USB3 adapters for external drives are not compatible and need a workaround to be usable.

Let’s check if your drive works well as-is, or if additional configuration is needed.

  • Install the software to measure the performance of your drive

    $ sudo apt install hdparm
  • Your external disk should be connected as /dev/sda. Check if this is the case by listing the names of connected block devices

    $ lsblk -pli
  • Measure the speed of your external drive

    $ sudo hdparm -t --direct /dev/sda
    > Timing O_DIRECT disk reads: 932 MB in  3.00 seconds = 310.23 MB/sec

If the measured speed is more than 50 MB/s, you’re good, no further action needed.

If the speed of your USB3 drive is not acceptable, we need to configure the USB driver to ignore the UAS interface.

Check the Fix bad USB3 performance entry in the Troubleshooting guide to learn how.

Data directory

We’ll store all application data in the dedicated directory /data/. This allows for better security because it’s not inside any user’s home directory. Additionally, it’s easier to move that directory somewhere else, for instance to a separate drive, as you can just mount any storage option to /data/.

  • Create the data directory

    $ sudo mkdir /data
    $ sudo chown admin:admin /data

Increase swap file size

The swap file acts as slower memory and is essential for system stability. The standard size of 100M is way too small.

  • Edit the configuration file and comment the entry CONF_SWAPSIZE by placing a # in front of it. Save and exit.

    $ sudo nano /etc/dphys-swapfile
    # comment or delete the CONF_SWAPSIZE line. It will then be created dynamically
  • Recreate and activate new swapfile

    $ sudo dphys-swapfile install
    $ sudo systemctl restart dphys-swapfile.service

Next: Security »