Documentation/Connecting/Your server by hand/State, updates, removal·2 / 3
State, updates, removal
State, updates, port, DNS, a backup and a move, removal — a command each.
Whether Veli works, its version and port, how many devices there are and how many are connected now, whether they get out to the internet. What is wrong, it says in words, with the command to fix it
sudo veli statusFinds a new version on our site, checks our signature and installs it. If the new one does not work, the previous one comes back. If someone is connected, it asks first: devices reconnect by themselves in a few seconds
sudo veli updateUpdate by itself: once a day, when nobody is connected. Without it Veli waits for sudo veli update. It turns off the same way, with --auto off
sudo veli update --auto onWhy a device does not connect. It checks the service, the port, the way to the internet, DNS, the server's firewall and clock, then asks you to connect a device and tells whether it reaches the server. Most often the port is closed in the hosting's panel — it says so
sudo veli doctorAnother port without a reinstall: the keys and devices stay, the old port closes once the new one works. The devices' links change — show them again
sudo veli set port 8443DNS for every device: adguard — no ads or trackers, adguard-family — no adult sites either, or cloudflare, google, quad9 or addresses of your own. No link changes
sudo veli set dns adguardWhere the links lead: the server's name instead of its IP address. With a name, a move to another server goes unnoticed by the devices
sudo veli set host vpn.example.comA copy under a password: the server's key and every device. Keep it as you keep a password
sudo veli backupA move to a new server out of the copy: the devices work with their links. Links to an IP address are to be shown again; links to a name — point its A record at the new address
sudo ./veli install --restore veli-backup.vbkRemove Veli entirely: the program, the service, the keys, the firewall rules and the command itself. The server is as it was before the install; nothing else on it is touched
sudo veli uninstallThe keys, the device list and the port survive an update: the links stay as they are.
With the app
The command and the app manage the same Veli: the devices are shared, either can update it.
- The app joins in — Add the server to the app over SSH as usual. It finds the Veli the command installed and offers “Add this device” on the server's screen. The devices connected already keep working.
- One list of devices — Devices from the app show in sudo veli list, and those the command added show in the app. Either can be taken off from either side.
- The command beside the app's Veli too — When the app installs or updates Veli, it puts the veli command beside it, if the server reaches our site. You can manage the server from its terminal even if you did not install by hand.
- Anyone can update — The app, sudo veli update and the update by itself install only a newer version, never an older one over a newer. It does not matter who updates first.
For scripts and fine-tuning
Options of the veli command for scripts and for an install with your settings.
--lang en- The language of the answers: ru or en. Without it — the system's
--json- An answer for programs — with add, show, list and status
--yes- No questions — with update, set and uninstall
--port 8443- At install: a port instead of 443, the same for TCP and UDP
--host vpn.example.com- At install: the address in the devices' links, such as the server's name instead of its IP address
--dns adguard- At install: the DNS for the devices — adguard, adguard-family, cloudflare, google, quad9 or addresses, comma apart
veli help- All the commands and options