SPS Validator Node: Setup Guide for Dummies on Mac

@hanv · 2025-03-12 09:16 · splinterlands

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!

#splinterlands #sps #hive #spschain #validator #node #macos #validator-node
Payout: 0.000 HBD
Votes: 37
More interactions (upvote, reblog, reply) coming soon.