Running Obyte wallet on headless RaspberryPi 3+
Let’s build and run a headless Obyte wallet on RaspberryPi 3+. We’re going to run Obyte light node. Running a full node is too slow to sync and the first database buildup can take weeks-months to complete Raspberry Pi 3+.
I also tried to do the full node syncing on another computer and then copied that DB into the Raspberry. Still, keeping it in sync was too much for Raspberry so it didn’t work out even then.
Prepare image on to the SD card
Go with the Raspbian Stretch Lite image from here https://www.raspberrypi.org/downloads/raspbian/. Raspian is based on Debian Linux.
Next, download balenaEtcher (https://www.balena.io/etcher/) for burning that image onto the SD card. If you haven’t used it yet then the balenaEtcher is a very easy, convenient way to burn OS images into the SD & USB drives.
Note that I have 16GB SD card in my example, 8GB is more than enough.
Configure SSH & Wifi (if needed)
Now, enable SSH so you could connect into your Raspberry Pi without a need for a screen and keyboard. I’m going to use cable LAN and therefore don’t need to setup Wifi connection at the beginning.
To setup SSH you need to create the file
ssh into the boot folder. Basically, there are two volumes -
rootfs. Create empty file names
ssh and validate that it’s there.
For Wifi setup create a file named
wpa_supplicant.conf again into the boot folder with the following content:
# ISO/IEC alpha2 country code in which the device is operating
This file will be copied on the first boot into the
Find your Pi and log in
Now it’s time to put SD card into the Raspberry, connect LAN and power up.
You need to find your device IP address. One option is to assume that it has default hostname. In that case, you could
ping raspberrypi.local to get it. The easiest way!
Other ways are to use
arp -a, nmap (more info here https://www.raspberrypi.org/documentation/remote-access/ip-address.md) or get IP addresses list from your router and find it from there.
Log in using SSH using IP or
ssh raspberrypi.local. The default username is “pi” and password “raspberry”. Change your password after login.
Update and configure
When logged in, first update its system.
sudo apt update
sudo apt upgrade
Then check Raspberry configuration tool to setup Wifi (if needed and you didn’t do this before) and extend the file system. Run
For the menu “Advanced Options” choose “Expand Filesystem”. This will make Raspberry use the whole SD card.
To be sure that the system is updated you could also run “Update” from there.
Install NodeJS, Git, Tor, and Screen
curl -sL https://deb.nodesource.com/setup_11.x | sudo -E bash -
sudo apt install nodejs git screen tor
I also like to use
sysv-rc-conf, but there’s no need to install these for this setup.
“Screen” will be used to run a wallet on the background while remaining overview of the situation. This is totally optional.
Changing the swap file size
By default, Raspian comes with a small swap file setting, which helps to preserve the SSD lifetime. This might not be optimal or even enough to build some of the binaries for the Obyte headless wallet. To change swap file settings, you need to open the following file:
sudo nano /etc/dphys-swapfile
CONF_SWAPSIZE=2048, press CTRL-X and then press Y and ENTER to save and close the editor.
After that restart the swap service with these commands:
sudo /etc/init.d/dphys-swapfile stop
sudo /etc/init.d/dphys-swapfile start
It is recommended to change the setting back to the original number after you have done running
Clone and configure wallet
Now clone “headless-obyte” from Github.
git clone https://github.com/byteball/headless-obyte.git obyte
Create the user configuration file into
~/.config/headless-obyte/conf.json and enter the following.
"socksLocalDNS": true, "control_addresses": [""], "bLight": true,
socksLocalDNSif you don’t wish to use TOR.
Also, you can also define
control_addresses (array) with your Obyte wallet device address, so you can control your wallet remotely or
payout_address, to restrict, which addresses the wallet can withdraw funds.
Run & enjoy
node start.js --max-old-space-size=2048
It will ask to set the passphrase. Later on every run it also asks that. This is used to protect your wallet private keys.
If you flashed your Raspberry Pi with Raspbian 10 (Buster) image and the node doesn’t start, you might need to start your node like this:
LD_PRELOAD=/usr/lib/arm-linux-gnueabihf/libatomic.so.1.2.0 node start.js — max-old-space-size=2048
This might not be needed in the future when some of the dependencies get fixed to run on Raspbian 10, but in case you don’t have that file, you can find the atomic library with the following command:
sudo find / -type f -name *atomic.so*
and you can add the following line to the end of your
~/.bashrc file, just run
source ~/.bashrc after you have edited the file:
Pairing with wallet chatbot
When you run the node, “my pairing code” is the code that you can use to connect a headless wallet with your Obyte wallet.
====== my pairing code: *****************@obyte.org/bb#randomstring
When everything works you can “Ctrl + a + d” to detach that screen. And with the command
screen -r go back into it. “Ctrl + d” or `exit` to terminate.
An issue to be dealt with will be handling growing log file size. One option is to disable the log, but it won’t suggest doing that.
For now, if everything runs without errors turn logs off by adding the following line into the conf.json file.
That’s it, folks!