← Back to Qweercoin

Run a Node

Help keep Qweercoin decentralised and strong — complete beginner's guide

What is a node?

A node is a copy of the Qweercoin software running on your computer. It connects to other nodes around the world and together they form the Qweercoin network — with no banks, no middlemen, no centralised control.

Every node independently checks that every transaction is valid. The more nodes there are, the harder it is for anyone to cheat. Running a node is a direct act of community power.

Pick your operating system above — all the instructions for your system are together in one place.

Node vs Mining: Running a node keeps the network healthy. Mining earns you QWR. You can do both at once — or just run a node for free.
What you'll need
COMPUTERAny Mac, Windows PC, or Linux
RAM512 MB free (most have 8+ GB)
STORAGE~1 GB to start, grows slowly
INTERNETAny home broadband connection
🍎

macOS Guide

1 Open Terminal
  1. Press ⌘ Command + Space to open Spotlight Search
  2. Type Terminal and press Enter

A dark window with a blinking cursor appears — that's Terminal.

Terminal — zsh
yourname@Mac ~ %
Pasting: use ⌘ Command + V to paste into Terminal.
2 Download & Install
Download for macOS

After downloading, paste these into Terminal one at a time:

↓ PASTE — press Enter after each line
cd ~/Downloads
tar xzf qweercoin-v0.1.0-macos-arm64.tar.gz
sudo cp qwr-v0.1.0-macos/qweercoind qwr-v0.1.0-macos/qweercoin-cli /usr/local/bin/
The sudo command asks for your Mac password. Type it and press Enter — nothing appears as you type, which is normal.

Verify it worked:

qweercoind --version
If you see Qweercoin Core v0.1.0 — you're installed!
3 Start Your Node
↓ PASTE — press Enter
qweercoind -daemon

You'll see: Qweercoin Core starting

Wait 30 seconds, then check it's running and finding other nodes:

qweercoin-cli getblockchaininfo
qweercoin-cli getpeerinfo
Terminal
% qweercoin-cli getblockchaininfo
{
  "chain": "main",
  "blocks": 514,
  ...
}
Seeing block data means your node is live on the Qweercoin network!
"Could not connect to server"? Wait 30 more seconds and try again.
4 Auto-start at Login

Make Qweercoin start automatically when your Mac turns on. First find your username:

whoami

Then paste the block below, replacing YOUR_USERNAME with the result:

↓ REPLACE YOUR_USERNAME — then paste the whole block
cat > ~/Library/LaunchAgents/org.qweercoin.node.plist <<'PLIST'
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
  "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0"><dict>
  <key>Label</key><string>org.qweercoin.node</string>
  <key>ProgramArguments</key><array>
    <string>/usr/local/bin/qweercoind</string>
  </array>
  <key>RunAtLoad</key><true/>
  <key>KeepAlive</key><true/>
  <key>StandardOutPath</key>
  <string>/Users/YOUR_USERNAME/Library/Logs/qweercoin.log</string>
  <key>StandardErrorPath</key>
  <string>/Users/YOUR_USERNAME/Library/Logs/qweercoin.log</string>
</dict></plist>
PLIST
launchctl load ~/Library/LaunchAgents/org.qweercoin.node.plist
Your node will now start automatically every time you log into your Mac.
5 Open Port 9444 (Optional)

Letting other nodes connect to yours makes the network stronger. macOS doesn't block outbound connections by default, so your node already works. To also accept inbound connections, open TCP port 9444 on your router.

  1. Find your local IP address first:
ipconfig getifaddr en0
  1. Log in to your router — usually at 192.168.1.1 or 192.168.0.1 in a browser
  2. Find Port Forwarding (may be under "Advanced" or "NAT")
  3. Add a rule: Protocol TCP, Port 9444, pointed at your local IP
  4. Save and apply
6 Useful Commands

Check the blockchain:

qweercoin-cli getblockchaininfo

See your peers:

qweercoin-cli getpeerinfo

Stop the node gracefully:

qweercoin-cli stop

Watch the live log:

tail -f ~/Library/Application\ Support/Qweercoin/debug.log

Press Control + C to stop watching the log.

🪟

Windows Guide

1 Open PowerShell
  1. Click the Start menu and search for PowerShell
  2. Right-click Windows PowerShellRun as Administrator
  3. Click Yes if a security prompt appears
Windows PowerShell (Administrator)
PS C:\Windows\system32>
Pasting into PowerShell: right-click inside the window to paste.
2 Download & Install
Download for Windows
  1. Right-click the downloaded .zip file → Extract All
  2. Extract to C:\Qweercoin

Now add Qweercoin to your PATH so you can run it from anywhere:

↓ PASTE INTO POWERSHELL (Administrator) — press Enter
[Environment]::SetEnvironmentVariable("Path", $env:Path + ";C:\Qweercoin", "Machine")

Close and reopen PowerShell as Administrator. Then verify:

qweercoind --version
If you see Qweercoin Core v0.1.0 — you're installed!
3 Start Your Node

Start Qweercoin in a hidden background window:

↓ PASTE — press Enter
Start-Process qweercoind.exe -WindowStyle Hidden

Wait 30 seconds, then check it's running:

qweercoin-cli getblockchaininfo
qweercoin-cli getpeerinfo
Seeing block data means your node is live on the Qweercoin network!
"Could not connect to server"? Wait 30 more seconds and try again.
4 Auto-start at Login

Make Qweercoin start automatically when you log into Windows:

  1. Press Windows key + R, type shell:startup, press Enter — a folder opens
  2. Right-click inside the folder → New → Shortcut
  3. For the location, type: C:\Qweercoin\qweercoind.exe
  4. Click Next, name it Qweercoin, click Finish
Qweercoin will now start silently in the background every time you log into Windows.
5 Open Port 9444 (Optional)

Letting other nodes connect to yours makes the network stronger. First, allow port 9444 through the Windows firewall:

↓ PASTE INTO POWERSHELL (Administrator)
New-NetFirewallRule -DisplayName "Qweercoin" -Direction Inbound -Protocol TCP -LocalPort 9444 -Action Allow

Then forward the port on your router:

  1. Find your local IP — in PowerShell run ipconfig and look for IPv4 Address (e.g. 192.168.1.45)
  2. Log in to your router — usually at 192.168.1.1 in a browser
  3. Find Port Forwarding and add: Protocol TCP, Port 9444, to your local IP
  4. Save and apply
6 Useful Commands

Check the blockchain:

qweercoin-cli getblockchaininfo

See your peers:

qweercoin-cli getpeerinfo

Stop the node gracefully:

qweercoin-cli stop

Watch the live log:

Get-Content "$env:APPDATA\Qweercoin\debug.log" -Wait -Tail 20

Press Control + C to stop watching the log.

🐧

Linux Guide

1 Open Terminal

Press Ctrl + Alt + T, or search for Terminal in your applications menu.

Terminal
user@linux:~$
Pasting: use Ctrl + Shift + V to paste into most Linux terminals.
2 Download & Install
Download for Linux

Then paste these into Terminal one at a time:

↓ PASTE — press Enter after each line
cd ~/Downloads
tar xzf qweercoin-v0.1.0-linux-x64.tar.gz
sudo cp qwr-v0.1.0-linux/qweercoind qwr-v0.1.0-linux/qweercoin-cli /usr/local/bin/
The sudo command will ask for your password. Type it and press Enter.

Verify it worked:

qweercoind --version
If you see Qweercoin Core v0.1.0 — you're installed!
3 Start Your Node
↓ PASTE — press Enter
qweercoind -daemon

You'll see: Qweercoin Core starting

Wait 30 seconds, then check it's running:

qweercoin-cli getblockchaininfo
qweercoin-cli getpeerinfo
Seeing block data means your node is live on the Qweercoin network!
"Could not connect to server"? Wait 30 more seconds and try again.
4 Auto-start at Login

Create a systemd service to start Qweercoin automatically with your Linux session:

↓ PASTE THE WHOLE BLOCK INTO TERMINAL
mkdir -p ~/.config/systemd/user
cat > ~/.config/systemd/user/qweercoin.service <<'SERVICE'
[Unit]
Description=Qweercoin Node
After=network.target

[Service]
ExecStart=/usr/local/bin/qweercoind
Restart=always
RestartSec=5

[Install]
WantedBy=default.target
SERVICE
systemctl --user enable qweercoin
systemctl --user start qweercoin
Your node will now start automatically with your Linux session.

Check status: systemctl --user status qweercoin

View logs: journalctl --user -u qweercoin -f

5 Open Port 9444 (Optional)

Allow other nodes to connect to yours for a stronger network.

If you're using UFW (Ubuntu, Debian):

sudo ufw allow 9444/tcp
sudo ufw reload

If you're using firewalld (Fedora, CentOS, Red Hat):

sudo firewall-cmd --permanent --add-port=9444/tcp
sudo firewall-cmd --reload

Find your local IP for router port forwarding:

hostname -I

Then log in to your router (usually at 192.168.1.1) and add a Port Forwarding rule: Protocol TCP, Port 9444, to your local IP.

6 Useful Commands

Check the blockchain:

qweercoin-cli getblockchaininfo

See your peers:

qweercoin-cli getpeerinfo

Stop the node gracefully:

qweercoin-cli stop

Watch the live log:

tail -f ~/.qweercoin/debug.log

Press Control + C to stop watching the log.

Common Questions

Do I earn anything for running a node?

Running a node alone doesn't earn QWR, but it supports the network. To earn coins too, check the Mining guide.

My node shows 0 connections for a while

Normal when the network is small and growing. Give it a few minutes. You can restart: stop with qweercoin-cli stop, wait a few seconds, then start again.

Terminal says "command not found"

Go back to Step 2 and re-run the install. On Mac/Linux make sure the sudo cp step completed. On Windows, make sure Qweercoin is added to PATH and you reopened PowerShell.

How much internet will it use?

Very little — a few MB per day when idle. Well within home broadband limits.

Can I run this on a Raspberry Pi or an old laptop?

Yes! Follow the Linux guide. A Raspberry Pi 3 or newer works great — just keep the device on.

How do I know if my node is healthy?

Run qweercoin-cli getblockchaininfo — if "blocks" is a positive and growing number, your node is syncing and healthy.