SPS Validator Node: Setup Guide for Dummies on Mac

Words
429
Reading
2 min
Listen
Play
2y

Hi!
I've created this guide for those who want to run a Validator node on a macOS without renting a server. If anything is unclear, doesn't work, or have any questions, feel free to leave a comment or contact me! I'll be happy to help.

Prepare

Install Docker Desktop on Mac
https://docs.docker.com/desktop/setup/install/mac-install/

2025-03-12-17-17-26.jpg

Run the Docker Desktop app

2025-03-12-17-21-09.jpg



Open Terminal Application

2025-03-12-18-07-11.jpg

Check if Git is already installed.
run

git --version

2025-03-12-17-22-37.jpg


If Git is not installed, you'll need to install Homebrew first (if you don't already have it):
run

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Install Git
run

brew install git

Run this command to create a folder where you'll install the validator files:

mkdir folder-name

cd folder-name

Install validator node files

run

bash -c "$(curl -s https://raw.githubusercontent.com/TheSPSDAO/SPS-Validator/refs/tags/vlatest/install.sh)"


2025-03-12-17-30-28.jpg

Type 1, you will get this error
Using production prefix...
sed: 1: ".env": invalid command code .

brew install gnu-sed
export PATH="/opt/homebrew/bin:$PATH"
export PATH="/opt/homebrew/opt/gnu-sed/libexec/gnubin:$PATH"

then run those

cd SPS-Validator

cp .env-example .env

nano .env

2025-03-12-17-51-06.jpg

Edit the following settings in the .env file:

POSTGRES_PASSWORD= : The password you want to set
APP_PASSWORD= : The password you want to set
DB_BLOCK_RETENTION= : 432000
VALIDATOR_ACCOUNT= : your hive account name
VALIDATOR_KEY= : your hive account posting key

2025-03-12-17-36-58.jpg

2025-03-12-17-37-14.jpg

control + x -> yes -> enter to save file

Build the validator

run

./run.sh build

  • This will deploy the database, run migrations, and download/deploy the snapshot
  • This process may take some time

2025-03-12-17-41-35.jpg

Start the validator

run

./run.sh start all

This starts both the validator and the management UI
This process may take some time

2025-03-12-17-42-27.jpg

You need to wait until the 'Blocks to head' value reaches 0 before your node can begin validating blocks.

2025-03-12-17-44-58.jpg



Wait 'Blocks to head' value reaches 0.

Manage and Register your Validator

Register Your Node

Once your node is fully synced (Blocks to head: 0),

Navigate to the management UI at http://localhost:8888/
Go to the "Manage Validator Nodes" section

2025-03-13-19-17-51.jpg

You can skip API url, Post URL, Reward account
After registration and once your node synced the block (Blocks to head: 0), set your node to "active"

Stake Licenses for Rewards

To earn LICENSE rewards:

Go to https://splinterlands.com/dashboard/licenses
Click Activate and Stake Licenses

2025-03-13-19-41-41.jpg

2025-03-13-19-42-40.jpg

Common Commands for Management

./run.sh stop: Stops all services
./run.sh start: Starts validator and database
./run.sh start all: Starts validator, database, and UI
./run.sh logs: Shows the validator logs
./run.sh rebuild_service validator: Rebuilds the validator to apply new environment variables (.env file)
./run.sh snapshot: Creates a backup of your database

Adjust the battery or power settings on your Mac to prevent it from automatically shutting down when not in use.

2025-03-12-17-55-57.jpg

Congrat! Now your validator node is running and you are getting License block reward! 🎉

You just made the SPS chain stronger and more decentralized! 💪

If this helps, please consider voting for my node
https://monstermarket.io/validators?validator=hanv
Thank you!

SPS Validator Node: Setup Guide for Dummies on Mac | Ecency