System configuration

System configuration

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


This guide have no defaults in mind, you can choose whathever tools you want

However, from MicroBolt we recommend EDITOR=vi and SU=doas

Define which text editor and root privileges tool you want

Add in a profile config file, replace <...> with your own choice

printf "%s\n" \
    "export EDITOR=<notepad,vi,vim,neovim,nano,micro,emacs...>" \
    "export SU=<sudo,doas,ssu...>" \
    > /etc/profile.d/

Source the changes

. /etc/profile.d/



Your choice may need additional steps, it's your responsibility

apk add $EDITOR $SU

Add the admin user

We will use the primary user satoshi instead of root to make this guide more universal.

Create a new user called satoshi with your password [A]

adduser satoshi

Make this new user a superuser by adding it to the wheel user group

adduser satoshi wheel

Allow members of the wheel group to use root privileges with $SU

sed 's/# permit persist :wheel/permit persist keepenv :wheel/' /etc/doas.conf > _
mv -f _ /etc/doas.conf

Log out


Log in with satoshi admin user

ssh satoshi@nakamoto01

System update

  • Enable community repository
$SU $EDITOR /etc/apk/repositories
  • Uncomment the following line

Do this regularly every few weeks/months for security-related updates.

Update the operating system and all installed software packages

$SU apk update

Upgrade the Alpine Package Manager itself

$SU apk add --upgrade apk-tools

Upgrade all installed packages

$SU apk upgrade --available

All services that have been upgraded need to be restarted, to begin using the upgraded version

$SU rc-service <service> restart

If the kernel is upgraded, it's required to reboot to begin using the upgraded version

sync && reboot

Check drive performance

Performant unit storage is essential for your node.

Let's check if your drive works well as-is.

  • Your disk should be detected as /dev/<drive>. Check if this is the case by listing the names of connected block devices
  • Install the software to measure the performance of your <drive>
$SU apk add hdparm
  • Measure the speed of your drive
$SU hdparm -t --direct /dev/<drive>
 Timing O_DIRECT disk reads: 690 MB in  3.00 seconds = 229.82 MB/sec

If the measured speeds are more than 150 MB/sec, you're good