Setting up an Ember node

Welcome! This guide walks you through setting up a node for Ember network. Running your own node means you can contribute to network security and decentralization, and earn rewards.

This page covers:

  • System Requirements

  • Preparing Your Environment

  • Downloading the Node Software

  • Configuring and Running Your Node

  • Maintaining Your Node

  • Troubleshooting

    System Requirements

    To run a node reliably, your system should meet the following minimum requirements:

    Component
    Minimum
    Recommended

    OS

    Linux (Ubuntu 20.04+), macOS, Windows 10+

    Linux (Ubuntu 22.04 LTS preferred)

    CPU

    2 cores

    4+ cores

    RAM

    2 GB

    4+ GB

    Disk Space

    4 GB free

    250+ GB SSD/NVMe for best performance

    Network

    Stable broadband (10 Mbps up/down)

    50+ Mbps up/down

    Other

    Open relevant ports in firewall

    UPS/power backup recommended

    Note: Disk usage grows over time as the Ember network data grows.

Preparing Your Environment

Before you install the node software, ensure:

✅ Your operating system is updated ✅ You have administrative privileges (sudo on Linux/macOS) ✅ Your firewall allows inbound/outbound connections on required ports ✅ Time synchronization is enabled (NTP recommended) ✅ Go (Golang) is installed

For Linux, run:

t# Update your system
sudo apt update && sudo apt upgrade -y

# Install basic tools
sudo apt install curl wget git tar -y

# Install Go (example installs Go 1.21)
wget https://go.dev/dl/go1.21.5.linux-amd64.tar.gz
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf go1.21.5.linux-amd64.tar.gz

# Add Go to your PATH
echo "export PATH=$PATH:/usr/local/go/bin" >> ~/.profile
source ~/.profile

# Verify installation
go version

Note: Check Go Downloads for the latest version compatible with your environment.

Downloading the Node Software

There are two components you're required to install

  • ember-cli

  • ember-operator

Clone the latest release of the node software from the official repository:

# Example generic download command
git clone http://github.com/mber-labs/ember-cli
git clone https://github.com/mber-labs/ember-operator

Configuring and Running your Node

Once you have cloned ember-cli and ember-operator, you can start the node.

cd ember-operator
go run .

Once node starts running, you'll see the RPC url through which node can be accessed on the terminal, copy it, go to ember-cli directory, and then run the following commands to create a new .ember-node file and paste RPC url to it.

cd ..
cd ember-cli
touch .ember-node
echo "<NODE-RPC-URL" > /.ember-node
go run .

You can use ember-cli to interact with the running node, and the network

Monitoring

Regularly monitor:

  • CPU and memory usage

  • Disk space

  • Network connectivity

  • Node logs for errors

Recommended tools include:

  • htop for system resource usage

  • journalctl or log files for service logs

  • Monitoring dashboards like Grafana

Troubleshooting

Issue
Possible Cause
Solution

Node not syncing

Outdated software, firewall block

Update node software, check ports

High CPU usage

High network activity

Monitor processes, upgrade hardware

Low peer connections

Network restrictions

Check firewall, adjust peer settings

Disk space running out

Growing network size

Add disk space

If issues persist, join the community forums or Discord for assistance.

PreviousLending

Last updated