VPS Guide
This guide will help you set up and run your node on a Linux-based VPS using the CLI (Command Line Interface)
1️⃣ Download the CLI to your VPS
To download the CLI tool directly to your VPS, use the wget
or curl
command. This will save you the trouble of downloading it to your local machine and transferring it via FTP.
For macOS, you can use this command:
Make sure to replace the URL with the correct download link for the CLI version you need: https://github.com/xprotocol-org/xardian
2️⃣ Make the CLI executable
Once the download is complete, you need to make the file executable. Use the ls
command to check that the file has been downloaded correctly:
You should see runner.linux.amd64
in the list. Now, change its permissions to make it executable by running:
3️⃣ Run the Xardian CLI
Now that the file is executable, you can start it. Note: In Linux, you must precede the filename with ./
to run an executable from the current directory.
Run the CLI with:
Take a look at the output to understand the syntax of the program:
4️⃣ Delegate
Before fully setting up, you'll need to complete the delegation process. To do this, run the following command:
The program will walk you through the steps for delegation. Copy the generated URL and open it in your browser. On the XProtocol site, click "Connect Wallet" to link your wallet. Make sure you have some Base ETH for gas fees.
After assigning, enter your public wallet address into the console and press enter. You'll then see a confirmation message: "Delegation Successful."
5️⃣ Receive Rewards
After completing the delegation process, you can start running your node to begin receiving rewards. Run this command:
If your node is running correctly, you should see something like this:
By default, if you disconnect from the VPS (close your terminal or lose your connection), your node will stop running. To prevent this, you can use the nohup
command, which allows you to run your node after disconnecting the VPS.
Credit to DEPINspirationHUB for helping with the VPS video tutorial.
⚙️ Troubleshooting
"Command not found" error: If you get this error when trying to run the CLI, make sure you're using
./runner.linux.amd64
. On Linux and macOS, executables need to be preceded by./
when running from the current directory.Download issues: If you don’t use
wget
orcurl
, you’ll need to manually download the file on your local machine and then transfer it to your VPS using FTP, which adds more steps.
📘FAQ
Last updated