If something is wrong
Run this first. It answers almost everything, from your own machine:
curl -fsSLO https://api.devnet.xandeum.me/vnode-doctor.sh
sudo bash vnode-doctor.shRead-only — it starts nothing, stops nothing and writes nothing. It checks your node against the network's configuration and prints a PASS / WARN / FAIL list with the fix for each failure.
| What you see | What it means |
|---|---|
| Not in gossip; validator restarts repeatedly but looks healthy | VPS panel firewall. Open UDP 8000–8030 and TCP 8000 there. ufw is not the only firewall. |
| In gossip, but the doctor says "advertising ONLY a gossip address" | No snapshot loaded — the node never finished starting. Not a firewall problem. Fetch a snapshot and restart. |
| Doctor says "YOUR NODE IS AT SLOT 0" | Same cause. Replaying from genesis never finishes. Move the ledger aside, refetch genesis and a fresh snapshot, restart. |
| Runs, looks healthy, 0 credits, never votes | You ran it as root. Keys and ledger are in /root, unreadable by the service user. |
| Caught up, everything correct, still no votes | Normal. See "About voting" below. Do not report this. |
| Node advances but far too slowly and never catches up | Stale snapshot. Refetch and restart — waiting cannot fix it. |
[WARN] libpoh-simd.so MISSING | You are on an older binary bundle. Your node syncs and votes correctly; this only affects block production once you hold stake. Re-run the installer to fix it. |
The network calls you DELINQUENT | Two different causes. Stake that has not activated yet is normal — wait. A node that voted for days and then stopped is broken — act now. vnode-toolbox tells you which of the two you are looking at. |
Then the toolbox — the status to paste when you report
sudo curl -fsSL https://api.devnet.xandeum.me/vnode-toolbox.sh -o /usr/local/bin/vnode-toolbox
sudo chmod +x /usr/local/bin/vnode-toolbox
vnode-toolbox statusvnode-toolbox status prints a one-shot summary of identity, vote account, stake, commission, balances, epoch progress and host health — paste it alongside the doctor's output. Running vnode-toolbox with no argument opens the same information as an interactive panel: arrow keys to move, enter to select, q to quit.
It targets this chain by construction, so you never need solana config set --url — forgetting that is how solana balance silently answers from a different cluster.
The installer fetches the toolbox at the end of a run, so the three commands above are only for operators who installed before 7 September 2026.
The toolbox can optionally share host state — disk, service, config, backup — with the network coordinator. Every category ships off, the installer never enables one, and the panel shows you exactly what a category would send before you switch it on. It is your decision, and it is neither recommended nor assumed either way.
.sh on the toolbox URL is required.The host serves only files ending in .sh or .tar.gz as static downloads, and every other path falls through to the RPC proxy, which answers 405 to a plain GET. The file installs locally as vnode-toolbox, with no extension — that part is correct as written above.
About voting — please read before reporting a problem
A new node does not vote immediately, and that is expected.
Your votes are only counted once your stake is in the epoch stake set, which happens an epoch or two after your grant is issued. Until then your node can be fully synced, correctly configured, and sending votes that reach the network — and still show zero credits.
This is normal. It is not a fault, and there is nothing to fix. If the doctor gives you a clean run, you are done: wait for the epoch boundary.
Report it only if the doctor shows a FAIL. Include the doctor's full output and the vnode-toolbox status summary.
A community-operated DevNet for the Xandeum protocol.
Not affiliated with or endorsed by Xandeum.
Nothing on this network is money, and nothing here is offered as money. Tokens on this network are valueless test tokens on an independent test chain: they have no monetary value, cannot be sold, and are not an investment. There is no ticker and no exchange listing, by design. Stake grants, commission and anything a vote account accrues are denominated in those same valueless test tokens. Operating a vNode is unpaid volunteer work.
They are not Solana SOL — some tools display “SOL”, and may even show a dollar price, because they are pricing an unrelated token. The correct reading of any such figure is $0.
This network does not provide Xandeum storage.
Discussion
No replies yet.
Sign in and join this network to take part.