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
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 installThe 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.
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 serversudo 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.
sudo veli add laptopsudo veli listsudo veli show laptopsudo veli rename laptop mumsudo veli remove laptop