Automated Setup for dVPN Node

Step 1: Follow all these commands

To make the setup process simple, Qubetics provides an automated script that installs and configures a dVPN node with minimal manual steps. The script handles dependencies, firewall rules, and WireGuard setup for you.

It is a Linux script that provides a very easy way to spawn a Qubetics dVPN node via the command line.

GitHub Repo: https://github.com/Qubetics/testnet-dvpn-node-script.git

NOTE: This script has been tested and run on Ubuntu 22.04/24.04 under the root user

This script registers the node into the Qubetics network. While registering, a balance of atleast 20TICS is required from the node operator’s wallet ( 10TICS is required as a node registration deposit. Additionally, it’s recommended to keep some balance for future transactions to cover the transaction fees ). The 10TICS deposit funds go directly to the community pool. This is not a user wallet or a provider wallet, but a community pool (module account). If these funds need to be withdrawn, it can only be done through governance.

Note: The remote_url parameter should always point to the node’s public IPv4 address instead of a domain name. Using a domain (for example https://dvpinn.pw:18133) can cause issues because the dVPN network relies on the actual IP address to determine the node’s geographic location, verify registration, and enable peer-to-peer connectivity. When a domain is used, the system cannot accurately fetch or verify the real IP, which affects node visibility and routing performance. Additionally, DNS resolution adds an extra dependency layer that can fail or delay connections if the domain is misconfigured, cached incorrectly, or points to a different IP. Since peers in the Qubetics network connect directly via IP for handshake and routing, using a domain name may lead to failed connections. Therefore, it is always recommended to bind the remote_url directly with the public IPv4 address (for example, https://:18133) to ensure accurate registration, stable peer connectivity, and reliable network discovery.

Prerequisites

A Linux VPS (Ubuntu 22.04/24.04 recommended) OR a Linux Ubuntu machine running on a residential ISP.
Minimum specs:
- 2vCPU
- 2 GB RAM
- 10 GB Disk
Stable Internet Connection
Operating System: Linux (preferably Ubuntu)
Root or sudo privileges.

Setup Steps

If you are running on a Cloud Server (AWS, Google Cloud, Azure, etc.) Most cloud providers give you an Ubuntu instance where you already have root access. In this case, you can directly clone the repository and follow the steps mentioned in the README.

Note: Make sure to allow ports 51280 and 18133 on the instance.

Port 51280 is used for WireGuard, and port 18133 is used for the node API.

If you are running on your own machine with a Residential ISP (home internet) or inside VMware/VirtualBox You might not be logged in as root by default. First, switch to root using the command below:

sudo su

After that, clone the repository and continue with the steps from the README.

Clone the repository git clone https://github.com/Qubetics/testnet-dvpn-node-script.git

cd testnet-dvpn-node-script

.
├── .gitignore
├── README.md
├── install-go.sh
├── setup_wireguard.sh
└── start-node.sh

install-go.sh          Install Go toolchain
setup_wireguard.sh     Setup WireGuard VPN interface
start-node.sh          Main node manager & service control script

Follow the Readme file https://github.com/Qubetics/testnet-dvpn-node-script/blob/main/README.md

Node operators should run in sequence:

1) git clone https://github.com/Qubetics/testnet-dvpn-node-script.git

2) cd testnet-dvpn-node-script/

3) ./install-go.sh

4) source ~/.bashrc

5) source ~/.profile

6) go version

7) sudo ./setup_wireguard.sh

8) ./start-node.sh init

Note: Before running ./start-node.sh start, ensure that TICS has been added to the wallet address that is created while init command add balance of around 20 TICS.

9) ./start-node.sh start

10) ./start-node.sh status

For check logs use journalctl command

journalctl -u dvpn-node.service-f

Here is an example we tested on one of the cloud servers. 1) Open a root terminal.

2) Clone the repo: git clone https://github.com/Qubetics/testnet-dvpn-node-script.git .

3) Go to the cd testnet-dvpn-node-script directory.

4) First we run ./install-go.sh to install Go.

5) After installing Go, run source ~/.bashrc and source ~/.profile.

6) Then run sudo ./setup_wireguard.sh to install WireGuard.

7) Help command showing which commands are available inside the file.

Note: Before running ./start-node.sh init, ensure that both WireGuard and Go are installed on your machine.

8) After installing WireGuard, we ran ./start-node.sh init.

9) After the command completes successfully, copy the displayed key, as it is associated with your node.

Note: Before running ./start-node.sh start, ensure that TICS has been added to this wallet address around 20 TICS.

10) After adding TICS, run ./start-node.sh start. Once it starts successfully, wait for 30 seconds to allow the node to initialize, and then save the node address. This node address will be used later.