Skip to main content

Raspberry Pi guide

How install and run a node on a Raspberry Pi device

Andzej Korkuz avatar
Written by Andzej Korkuz
Updated over a week ago

The Raspberry Pi is a low-cost, low-power mini-computer ideal for running MystNodes 24/7. Once set up, it operates independently and enables you to earn rewards passively.

You can purchase a Preloaded Raspberry Pi with Mystnodes installed, but we recommend buying one locally and following this guide.


Supported Raspberry Pi Models

  • Raspberry Pi 3B

  • Raspberry Pi 3B+

  • Raspberry Pi 4B

  • Raspberry Pi 5


🔧 Method 1: Flash Mystberry OS Image (Beginner friendly, Recommended)

This is the easiest and fastest way to start. It uses a prebuilt OS image with MystNodes already installed.

✅ Ideal for: Beginners or clean setups
⚠️ Note: This will erase everything on the SD card

Steps:

  1. Download the image: mystberry.zip from official releases

  2. Download Balena Etcher: balena.io/etcher

  3. Flash the image to SD card:

    • Insert the SD card into your PC.

    • Open Balena Etcher.

    • Select mystberry.zip as the image.

    • Select your SD card as the target.

    • Click Flash!

  4. Insert the SD card into your Pi.

  5. Connect Ethernet cable to your router.

  6. Power on the Pi. Wait a few minutes for the system to boot.


NodeUI Setup

Once booted:

  1. Access NodeUI at: http://<raspberry-pi-ip>:4449

  2. Complete the onboarding process:

    • Set your payout (beneficiary) address

    • Review and configure service settings

  3. Create an account at Mystnodes.com and link your node using the provided API key (found in NodeUI).


SSH Access (Optional)

You typically don't need to log in, but if needed:

ssh myst@<raspberry-pi-ip>

If you get a "Permission denied" error:

ssh -o PreferredAuthentications=password -o PubkeyAuthentication=no myst@<raspberry-pi-ip>

Finding Your Pi’s IP

  • Log into your router (usually http://192.168.0.1)

  • Check LAN > Clients List

  • Look for the device named raspberrypi


Security: Change SSH Password

passwd

Reset Lost SSH Password

  1. Power off the Pi and remove the SD card.

  2. Insert it into your PC and open cmdline.txt.

  3. Add this to the end of the line:

    init=/bin/sh
  4. Reinsert the SD card into the Pi and boot.

  5. At the prompt, type:

    su 
    passwd myst
  6. Power down the Pi and remove the SD card.

  7. Edit cmdline.txt again and remove the init=/bin/sh part.

  8. Boot as usual.


🔧 Method 2: Install MystNodes Software Manually

(Use this if Method 1 doesn’t work)

If you already have Raspberry Pi OS running and just want to install the MystNodes software manually:

✅ Ideal for: Advanced users or custom setups

Steps:

  1. SSH into your Pi:

    ssh myst@<raspberry-pi-ip>
  2. Run the installation script:

    sudo -E bash -c "$(curl -s https://raw.githubusercontent.com/mysteriumnetwork/node/master/install.sh)"

This installs MystNodes software along with dependencies like Wireguard.


Optional: Install Pre-release Version

Add the pre-release repository:

grep -qxF 'deb http://ppa.launchpad.net/mysteriumnetwork/node-pre/ubuntu focal main' /etc/apt/sources.list || echo 'deb http://ppa.launchpad.net/mysteriumnetwork/node-pre/ubuntu focal main' | sudo tee -a /etc/apt/sources.list > /dev/null

Update and Check Available Versions:

sudo apt-get update sudo apt-cache policy myst

Identify the Candidate version, then install it:

sudo apt install myst=<candidate-version>

Example:

sudo apt install myst=0.47.0~rc0+build301789769+focal

🔧 Roll Back to Stable Version

  1. Run:

sudo apt-cache policy myst
  1. Note the Installed version string.

  2. Reinstall it:

sudo apt install myst=<installed-version>
Did this answer your question?