Documentation/Connecting/Your own panel/Nodes and clients·2 / 9
Nodes and clients
A node is one command on the panel's server: it signs in to the server over SSH, puts Veli and the protocols in place and ties the node to the panel. A client is a link with a term and a number of devices, one for all the nodes.
Add a node
The node's name, its server's address and the protocols beside Veli:
sudo veli nodes add de1 --ssh root@203.0.113.5 --protocols veli,reality,trojanOn the screen: The server's SSH fingerprint and a question whether to trust it — check the fingerprint against the host's panel. Then the install steps and “The node is up”. If something fails, the server stays as it was — run the command again.
A protocol's port goes after a colon: --protocols veli,trojan:2083. Hysteria2 and TUIC — on x86-64 only.
Signing in to the server
-i- The private key file. Without it the command tries the keys in ~/.ssh, then asks for a password
--password-stdin- The SSH password from the input — for scripts
--fingerprint- The server's fingerprint beforehand, SHA256:… — no question is asked
--from, --node-from- Take the built veli and node from a disk — for a server our site does not open on
From another machine
The same commands work from a laptop or a work server that has veli. The token with the all right goes in a variable, not in the command line.
sudo veli token add laptop --rights all --days 7export VELI_PANEL_TOKEN=…veli nodes add de1 --panel <API address> --ssh root@203.0.113.5 --protocols veli,reality,trojanA batch and user-data
sudo veli nodes add --file servers.txtsudo veli nodes add de2 --protocols veli,trojan --cloud-initThe “user-data” text holds the node's token: treat it as a password and paste it only into the host's form.
The list, protocols, removal
sudo veli nodessudo veli nodes protocols de1 --ssh root@203.0.113.5 --add hysteria2sudo veli nodes remove de1 --ssh root@203.0.113.5Clients
A client is a link with a term and a number of devices: one for all the panel's nodes.
sudo veli users add anna --days 30 --devices 3sudo veli userssudo veli users link annasudo veli users extend anna --days 30sudo veli users remove annaThe client pastes the link into Veli (“Add” → paste) or opens it in a browser: the page tells about the other apps.
A move from another panel
The clients of Remnawave, Marzban, 3x-ui, Hiddify and of a CSV table come over with their terms, limits and devices. Without --yes the command only checks and writes nothing; “-” in place of a token or password — the command asks for it itself.
sudo veli panel import remnawave https://old.example.com --token -sudo veli panel import 3x-ui --file x-ui.dbsudo veli panel import csv --file clients.csv --skip-expired --redirect --yessudo veli panel export --format csv --out clients.csvOther flags: --rename — a taken name becomes “name-2”, --skip-disabled — no disabled clients, --devices N — places for clients with no device limit (3 by default), --redirect — old links lead to the new ones. The table's columns are shown by panel export.