SPS Validator Node: Setup Guide for Dummies on Mac

(Edited)

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 .

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!



0
0
0.000

2 comments

Congratulations @hanv! You have completed the following achievement on the Hive blockchain And have been rewarded with New badge(s)

You received more than 200 upvotes.
Your next target is to reach 300 upvotes.

You can view your badges on your board and compare yourself to others in the Ranking
If you no longer want to receive notifications, reply to this comment with the word STOP

0
0
0.000