XProtocol Litepaper
  • Overview
    • XProtocol
      • What makes XProtocol a Superchain?
    • Xardian Nodes
      • How to Purchase Nodes
        • Node Structure
        • Node Sale Contracts
      • How to Run Nodes
        • Install App Software
        • Assign Keys from New Wallet
        • Set Up Operator Wallet
        • VPS Guide
        • FAQ
        • Node-as-a-Service (NaaS) Provider
      • Emissions and Redemption Process
    • XForge DePIN Smartphone
      • How to Purchase XForge
      • How to Create Referral Code
      • How to Update Wallets
      • How to Run Nodes on XForge
    • Partnerships
    • Roadmap
    • Investors
    • XProtocol Service Agreement
  • Token
    • What is $KICK?
    • $KICK Tokenomics
  • Community
    • Official Website
    • Follow us on X (Twitter)
    • Join our Discord
  • MEDIA
    • Features & PR
    • Branding Kit
Powered by GitBook
On this page
  • 1️⃣ Download the CLI to your VPS
  • 2️⃣ Make the CLI executable
  • 3️⃣ Run the Xardian CLI
  • 4️⃣ Delegate
  • 5️⃣ Receive Rewards
  • ⚙️ Troubleshooting
  • 📘FAQ
  1. Overview
  2. Xardian Nodes
  3. How to Run Nodes

VPS Guide

This guide will help you set up and run your node on a Linux-based VPS using the CLI (Command Line Interface)

PreviousSet Up Operator WalletNextFAQ

Last updated 4 months ago

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.

wget https://github.com/xprotocol-org/xardian/releases/latest/download/runner.linux.amd64

For macOS, you can use this command:

curl -LO https://github.com/xprotocol-org/xardian/releases/latest/download/runner.darwin.arm64

Make sure to replace the URL with the correct download link for the CLI version you need:

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:

chmod +x runner.linux.amd64

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:

./runner.linux.amd64

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:

./runner.linux.amd64 delegate

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:

./runner.linux.amd64 run

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.


⚙️ 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 or curl, 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

How do I import my wallet?
  • ./runner.linux.amd64 import --key private_key --addresses publicaddress1,publicaddress2

  • replace private_key with the private key of the Xardian operator wallet and publicaddress1,publicaddress2 with the delegated address(es)

How can I earn rewards for new nodes added to my wallet?
Is it possible to switch to a different RPC?
./runner.linux.amd64 config --rpc {string}

Replace {string} with your preferred RPC endpoint. ./runner.linux.amd64 config --rpc https://base-rpc.publicnode.com

How do I import several keys in my CLI server?

Delegation is handled at the wallet level, so you don't need to delegate for each individual key. You only need to delegate once for the entire wallet.

Can I delegate more than one wallet?
How do I check my xKICK rewards?
What does this message mean: Submission already exists for the latest challenge, skipping assertion submission

This is a feature introduced in version 0.0.3. When the app starts or reconnects after a network issue, it checks if the current challenge has already been submitted. If it has, the app skips re-submitting it. If not, it processes the submission. This helps ensure that users with unstable connections don't miss out on rewards.

How do I export my operator wallet's private key?
How do I see other available commands?
./runner.linux.amd64 --help

Credit to for helping with the VPS video tutorial.

Simply delegate again (), but skip the signing part to save on gas fees

Yes, we've introduced support for HTTPS-based RPC endpoints. Be sure to update to the to access this feature.

Yes, you can delegate multiple wallets. Simply update to the , then run the delegate command for each wallet you want to delegate.

You can import the xKICK contract to your preferred wallet:

./runner.linux.amd64 export. Be sure to update to the to access this command.

DEPINspirationHUB
latest version
latest version
0xB51eFF119Ce6a238f67db7cA48431C3D319C7211
latest version
Step 4
https://github.com/xprotocol-org/xardian
DEPINspirationalHUB