Running Obyte wallet on headless RaspberryPi 3+

Alvar Laigna
Apr 7, 2019 · 5 min read

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 Raspian is based on Debian Linux.

Next, download balenaEtcher ( 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 into the boot folder. Basically, there are two volumes - and . Create empty file names and validate that it’s there.

For Wifi setup create a file named again into the boot folder with the following content:

# ISO/IEC alpha2 country code in which the device is operating
ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev

This file will be copied on the first boot into the folder.

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 to get it. The easiest way!

Other ways are to use , nmap (more info here or get IP addresses list from your router and find it from there.

Log in using SSH using IP or . 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 | sudo -E bash -
sudo apt install nodejs git screen tor

I also like to use and , 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

Then change , 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 obyte
cd obyte
npm install

Create the user configuration file into and enter the following.

"socksHost": "",
"socksPort": 9050,
"socksLocalDNS": true,
"control_addresses": [""], "bLight": true,
"bFaster": true

Don’t set , , and if you don’t wish to use TOR.

Also, you can also define (array) with your Obyte wallet device address, so you can control your wallet remotely or , 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/ 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 **

and you can add the following line to the end of your file, just run after you have edited the file:

export LD_PRELOAD=/usr/lib/arm-linux-gnueabihf/

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: *****************

When everything works you can “Ctrl + a + d” to detach that screen. And with the command 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.

“LOG_FILENAME”: “/dev/null”


That’s it, folks!

Obyte tutorials

Help and Tutorials about using Obyte