Tutorial 1: Running Privanetix Node on WSL (Windows Subsystem for Linux)

1. Recommended System Requirements

Ensure your Windows machine meets the following requirements before setting up WSL:

• Windows 10/11 (64-bit)

• WSL 2 enabled

• Ubuntu installed via WSL

Node Performance Levels:

Level	OS	Storage	Memory	Processor	Network
Level 1	Debian/Ubuntu	100GB	8GB RAM	16 cores	Public static IP, TCP port 8181 open
Level 2	Debian/Ubuntu	100GB	4GB RAM	8 cores	Public static IP, TCP port 8181 open
Level 3	Debian/Ubuntu	100GB	4GB RAM	4 cores	Public static IP, TCP port 8181 open
Level 4	Debian/Ubuntu	100GB	≤4GB RAM	≤2 cores	Public static IP, TCP port 8181 open

---

2. Install WSL and Ubuntu

Step 1: Enable WSL 2

Open PowerShell as Administrator and run:

powershellCopyEditwsl --install

After installation, restart your PC.

---

Step 2: Install Ubuntu on WSL

Open PowerShell and run:

powershellCopyEditwsl --install -d Ubuntu

Once installed, launch Ubuntu from the Start Menu.

---

Step 3: Install Docker on WSL

Run the following commands inside the WSL terminal (Ubuntu):

bashCopyEdit# Install dependencies
sudo apt update && sudo apt install -y apt-transport-https ca-certificates curl software-properties-common

# Add Docker’s official GPG key
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -

# Add Docker’s official repository
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"

# Update package index and install Docker
sudo apt update && sudo apt install -y docker-ce

Verify Docker installation:

bashCopyEditsudo docker --version

---

3. Pull and Run Privanetix Node

Step 1: Pull the Docker Image

bashCopyEditsudo docker pull privasea/acceleration-node-beta

Step 2: Switch to Root User and Setup Directories

bashCopyEditsudo su
mkdir -p /privasea/config && cd /privasea

Step 3: Generate Keystore File

bashCopyEditsudo docker run -it -v "/privasea/config:/app/config" privasea/acceleration-node-beta:latest ./node-calc new_keystore

Follow the prompts to set up a wallet password and save the generated node address.

Rename the keystore file:

bashCopyEditcd /privasea/config && ls
mv ./UTC--xxxxxxxxx--your-node-address ./wallet_keystore

Step 4: Start the Node

bashCopyEditcd /privasea
sudo docker run -d -v "/privasea/config:/app/config" \
  -e KEYSTORE_PASSWORD=your_password \
  privasea/acceleration-node-beta:latest

Step 5: Check Node Status

bashCopyEditsudo docker logs -f $(sudo docker ps -q --filter "ancestor=privasea/acceleration-node-beta:latest")

---

4. Stop the Node

bashCopyEditsudo docker ps -q --filter "ancestor=privasea/acceleration-node-beta:latest" | xargs --no-run-if-empty docker stop

Verify the node has stopped:

bashCopyEditsudo docker ps | grep privasea/acceleration-node-beta:latest

---

Tutorial 2: Running Privanetix Node on macOS Terminal

1. Recommended System Requirements

Ensure your Mac meets the following requirements:

• macOS Monterey or later

• Docker installed

• Terminal access with admin privileges

Node Performance Levels:

Level	OS	Storage	Memory	Processor	Network
Level 1	macOS/Linux	100GB	8GB RAM	16 cores	Public static IP, TCP port 8181 open
Level 2	macOS/Linux	100GB	4GB RAM	8 cores	Public static IP, TCP port 8181 open
Level 3	macOS/Linux	100GB	4GB RAM	4 cores	Public static IP, TCP port 8181 open
Level 4	macOS/Linux	100GB	≤4GB RAM	≤2 cores	Public static IP, TCP port 8181 open

---

2. Install Docker on macOS

Step 1: Install Homebrew (if not installed)

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

Step 2: Install Docker

bashCopyEditbrew install --cask docker

After installation, open the Docker Desktop app and ensure it is running.

Verify Docker installation:

bashCopyEditdocker --version

---

3. Pull and Run Privanetix Node

Step 1: Pull the Docker Image

bashCopyEditdocker pull privasea/acceleration-node-beta

Step 2: Setup Directories

bashCopyEditmkdir -p /privasea/config && cd /privasea

Step 3: Generate Keystore File

bashCopyEditdocker run -it -v "/privasea/config:/app/config" privasea/acceleration-node-beta:latest ./node-calc new_keystore

Set up a wallet password and note your node address.

Rename the keystore file:

bashCopyEditcd /privasea/config && ls
mv ./UTC--xxxxxxxxx--your-node-address ./wallet_keystore

Step 4: Start the Node

bashCopyEditcd /privasea
docker run -d -v "/privasea/config:/app/config" \
  -e KEYSTORE_PASSWORD=your_password \
  privasea/acceleration-node-beta:latest

Step 5: Check Node Status

bashCopyEditdocker logs -f $(docker ps -q --filter "ancestor=privasea/acceleration-node-beta:latest")

---

4. Stop the Node

bashCopyEditdocker ps -q --filter "ancestor=privasea/acceleration-node-beta:latest" | xargs --no-run-if-empty docker stop

Verify the node has stopped:

bashCopyEditdocker ps | grep privasea/acceleration-node-beta:latest

---

Final Notes

• For WSL users, make sure WSL 2 is enabled before installing Docker.

• For macOS users, ensure Docker Desktop is running before executing commands.

• If you face any issues, check network connectivity and retry.

🚀 Now your Privanetix Node is running successfully! 🚀