Network Guard

Setup scripts for running Bob Node and Lite Node on the Qubic network.

Table of Contents

Bob Node

1. Requirements
2. Quick Start
3. Management
4. Ports
5. Cloud Provider Examples
6. Firewall
7. Troubleshooting

Lite Node

8. Requirements
9. Quick Start
10. Management
11. Ports
12. Cloud Provider Examples
13. Firewall
14. Troubleshooting

General

15. Links

---

Bob Node

Blockchain indexer with REST API for the Qubic network.

Requirements

Component	Minimum
RAM	16 GB
CPU	4+ cores
Disk	100 GB SSD
Docker	Required

Quick Start

wget -O bob.sh https://raw.githubusercontent.com/Pomm3sgab3l/Network_Guard/main/scripts/bob.sh
chmod +x bob.sh && ./bob.sh

The script provides an interactive menu and stores data in /opt/qubic-bob.

Management

cd /opt/qubic-bob
./bob.sh status     # show status
./bob.sh logs       # view logs
./bob.sh stop       # stop node
./bob.sh start      # start node
./bob.sh restart    # restart node
./bob.sh uninstall  # remove node

Auto-Update: Watchtower automatically updates the node when new versions are released.

Ports

Port	Protocol	Description
21842	TCP	P2P (required)
40420	TCP	REST API

Cloud Provider Examples

The following providers have been tested with Bob Node:

• Hetzner Cloud
• Netcup / Hostkey
• OVH / Bare Metal
• AWS EC2
• Google Cloud
• DigitalOcean

Note: These are examples only. We do not guarantee that any provider permits running blockchain nodes. Please check the provider's terms of service before deploying.

Cloud-Init

Deploy with a single command using cloud-init.

Firewall

# UFW (Ubuntu)
sudo ufw allow 22/tcp      # SSH
sudo ufw allow 21842/tcp   # P2P
sudo ufw allow 40420/tcp   # API (optional)
sudo ufw enable

Troubleshooting

Problem	Solution
Container exits immediately	Check logs: docker logs qubic-bob
Not syncing	Wait a few minutes, check logs for peer connections
API not reachable	Check firewall, ensure port 40420 is open

---

Lite Node

Lightweight Qubic Core that runs on Linux without UEFI.

Requirements

Component	Testnet	Mainnet
RAM	16 GB	64 GB
CPU	x86_64	High-freq AVX2
Disk	-	500 GB SSD

Quick Start

wget -O lite.sh https://raw.githubusercontent.com/Pomm3sgab3l/Network_Guard/main/scripts/lite.sh
chmod +x lite.sh && ./lite.sh

The script provides an interactive menu and stores data in /opt/qubic-lite.

Management

cd /opt/qubic-lite
./lite.sh status    # show status
./lite.sh logs      # view logs
./lite.sh stop      # stop node
./lite.sh start     # start node
./lite.sh restart   # restart node
./lite.sh uninstall # remove node

Auto-Update: Watchtower automatically updates the node when new versions are released.

Ports

Port	Protocol	Description
21841	TCP	P2P (required)
41841	TCP	HTTP API

Cloud Provider Examples

The following providers have been tested with Lite Node:

• Hetzner Cloud
• Netcup / Hostkey
• OVH / Bare Metal
• AWS EC2
• Google Cloud
• DigitalOcean

Note: These are examples only. We do not guarantee that any provider permits running blockchain nodes. Please check the provider's terms of service before deploying.

Cloud-Init

Deploy with a single command using cloud-init.

Firewall

# UFW (Ubuntu)
sudo ufw allow 22/tcp      # SSH
sudo ufw allow 21841/tcp   # P2P
sudo ufw allow 41841/tcp   # HTTP API
sudo ufw enable

Troubleshooting

Problem	Solution
Build fails	Check if AVX2 is supported: grep avx2 /proc/cpuinfo
Not syncing	Check logs, verify peers are connecting
High CPU usage	Normal during sync

---

Links

• Bob Node: qubic/core-bob | Docker Hub
• Lite Node: qubic/core-lite | Docker Hub
• Qubic: Website | Network Dashboard