Documentation/Connecting/Your server by hand·1 / 3

Veli on a server without the app

One line in the server's terminal installs Veli, and the veli command adds devices, updates and removes it. It is the same Veli the app installs: you can manage it from either side.

What the server needs

An ordinary VPS at any host will do. The command checks the server itself before it installs: if something is missing, it says so and puts nothing on it.

Systems

  • Ubuntu22.04 · 24.04 · 26.04
  • Debian12 · 13
  • Fedora43 · 44
  • CentOS Stream9 · 10
  • Rocky Linux9 · 10
  • AlmaLinux9 · 10
  • Arch Linuxrolling

On each one, the install, devices, updates and removal are checked. Systems based on Debian and Ubuntu will do too.

CPU
Regular (x86-64) or ARM
Access
root, or a user with sudo
Address
A public IPv4. A server with IPv6 alone will not do
Port
443 over TCP and UDP, or any other: --port 8443
TUN
Almost every VPS has it. In OpenVZ and LXC containers it is turned on in the host's panel
Memory and disk
Veli takes about 20 MB of memory and 15 MB of disk. The simplest plan will do: 1 core and 1 GB of memory
Our site
The server downloads Veli from velivpn.com. If it cannot reach it — a server in Russia, for example — install from files: see “If the server cannot reach our site”

CentOS, Rocky and AlmaLinux 8, RHEL itself, Oracle Linux, Manjaro and other systems based on Arch or Fedora, and systems without systemd will not do.

Install

  1. Paste the line on the server

    Log in to the server over SSH and paste the line: it downloads the program, checks that it is our very file, and installs Veli. Whether it needs sudo, the line decides itself.

    curl -fLo veli https://velivpn.com/own-server/1.13.0-45e7dfa/veli-x86_64 &&
      echo "2e39f2aa4a21b91535399f881de4cb76847c0a5195b82aab50fbd85f19e0be15  veli" | sha256sum -c &&
      chmod +x veli &&
      $( [ "$(id -u)" = 0 ] || echo sudo ) ./veli install

    The command uname -m tells you the CPU: x86_64 is a regular one, aarch64 is ARM.

    In half a minute the program says “Done. Veli works on port 443” and stays on the server as the veli command. On Fedora, CentOS, Rocky and AlmaLinux it takes one to five minutes: packages install longer there.

    The server cannot reach our site? Install from files

  2. Add a device

    Its link and QR show right in the terminal. On a computer: press “Add” in Veli and paste the link. On a phone: “Add” → “Scan a QR code” in Veli — or point the phone's camera at the QR and open the link in Veli.

    On the server
    sudo veli add laptop

The commands here are written with sudo. Logged in as root, you need no sudo: just veli add laptop. On Rocky Linux, AlmaLinux and CentOS sudo does not look in /usr/local/bin — write the full path: sudo /usr/local/bin/veli add laptop. The command itself tells you how to call it on this server.

Devices

As many devices as you like, each with a link of its own. The link is like a password: whoever gets it connects as that device.

A new device: its link and QR right in the terminal
sudo veli add laptop
All the devices, those added from the app too: when, and from where
sudo veli list
A device's link and QR again
sudo veli show laptop
Rename a device: its link stays, nothing to change on the device
sudo veli rename laptop mum
Take a device off: its link stops working within seconds, and the others do not notice
sudo veli remove laptop