[Lite Node] Installation

Installation

The Lite Node installation is snap based and available for many platforms but natively supported on Ubuntu.

After installing snap installing the current bleeding edge lite node is as easy as:

> snap install diode-node --edge

This will download, install and start the diode node locally.

See basic information

> diode-node.info 
== Diode Node 0x090ad02cebd8fbbe0b411f5d870ab69d1004d6d8 ==
Version          : 1.2.1
Connected Devices: 0
Connected Peers  : 6

Current Epoch    : 664
Ticket Score     : 0

Previous Epoch   : 663
Ticket Score     : 0

Inspect and change configuration

All configuration parameters can be listed using snap get diode-node and set using snap set diode-node <key>=<value>

> snap get diode-node
Key         Value
data-dir    /var/snap/diode-node/2/nodedata_prod
edge2-port  41046,443,993,1723,10000
host        139.162.191.153
peer2-port  51055
private     0
rpc-port    8545
rpcs-port   8443
seed-list   diode://0xceca2f8cf1983b4cf0c1ba51fd382c2bc37aba58@us1.prenet.diode.io:51055 diode://0x7e4cd38d266902444dc9c8f7c0aa716a32497d0b@us2.prenet.diode.io:51055 diode://0x68e0bafdda9ef323f692fc080d612718c941d120@as1.prenet.diode.io:51055 diode://0x1350d3b501d6842ed881b59de4b95b27372bfae8@as2.prenet.diode.io:51055 diode://0x937c492a77ae90de971986d003ffbc5f8bb2232c@eu1.prenet.diode.io:51055 diode://0xae699211c62156b8f29ce17be47d2f069a27f2a6@eu2.prenet.diode.io:51055

Configuring the Host IP

The most important parameter for a lite-node is a publicly reachable host ip address and publicly reachable edge2-port port(s). These can be changed using snap set

snap set diode-node host=139.162.191.153
snap set diode-node edge2-port=41046,1723,10000

! IMPORTANT NOTE: Setting the host IP will work upon boot but will be over-written if the network sees the node on a different public IP address. snap get diode-node will reflect the IP address being used - whether via manual setting or via automatic override.

Starting / Stopping / Restarting

The service lifecycle can fully be managed through snap:

snap stop diode-node
snap start diode-node

Or in one command:

snap restart diode-node
5 Likes

Thanks for the draft @Knusperhaus would love to see this expand, maybe we will publish use cases to help people get there heads around it.

2 Likes

FYI - confirmed diode-node works great on Windows 11 WSL (Ubuntu) on an x86 CPU.
Steps:

  1. Verify system is Windows 11 and x86 CPU

My setup: Geekom box using Intel(R) Core™ i5-8259U CPU @ 2.30GHz 2.30 GHz and Windows 11 Pro build 22631.3880 and Windows Feature Experience Pack 1000.22700.1020.0

  1. Open Powershell and

> wsl --install

  1. Verify version with

> wsl -l -v

NAME STATE VERSION

  • Ubuntu Stopped 2
  1. Launch wsl with

> wsl

Welcome to Ubuntu 22.04.3 LTS (GNU/Linux 5.15.153.1-microsoft-standard-WSL2 x86_64)

  1. update packages

# sudo apt-get update

  1. install snap

# sudo apt install snapd

  1. verify snap

# snap version

snap 2.63+22.04
snapd unavailable
series 16
Windows Subsystem for Linux -
kernel 5.15.153.1-microsoft-standard-WSL2 (amd64)

  1. test simple snap package

# sudo snap install hello-world
# hello-world
Hello World!

  1. install diode lite node!

# sudo snap install diode-node --edge
diode-node (edge) v1.2.1 from Diode Labs installed

  1. start it up

# snap start diode-node
Started.

1 Like

Adding the logs command to view logs to the terminal

sudo snap logs diode-node -f
1 Like

Is it possible for the team to containerize this and make it available for Docker or Podman?

1 Like

Hey teneke,

Just to clarify the light node is already containerized using snap from snapcraft.io - Which is available for all major Linux distributions as well as for Raspberry PIs.

The snap integration has the benefit that its on installation hooked into the boot process and logging infrastructure of your system. Also updates are shipped automatically such as critical bug fixes. And lastly configuration management is easy through the configuration system provided by snap.

If you’re though interested in using docker specifically, this can be done of course, but we don’t offer pre-built images at the moment. We do have a docker file that we use to build raw release binaries, and it shouldn’t be too much work to use the result in a docker container itself.

We’re happy to take PRs on the GitHub repo: GitHub - diodechain/diode_node: Diode Relay Node

1 Like