Veli on your own server

Your own server with Veli — in one line

Take any Linux VPS and put Veli on it: to your ISP it looks like an ordinary website. Manage the server from the app or with the veli command in the terminal — whichever suits you.

  • ≈ 30 seconds to install
  • x86-64 and ARM
  • ≈ 20 MB of memory

Two ways

One server, your way

Not a fan of the terminal? The app does it all. Used to SSH? The veli command is enough. It is the same Veli: start in one and carry on in the other.

01From the app

Not a single command

  1. 01Add the server over SSH — the app finds out its system by itself
  2. 02Tick Veli and press “Install Veli”
  3. 03A new device: a name, and its QR code right on the server's screen

Five more protocols on the same server

  • Reality
  • AmneziaWG
  • WireGuard
  • Shadowsocks
  • OpenVPN
02From the terminal

With the one veli command

user@my-vps: ~
$ sudo veli list
Devices (3):
laptop added 2026-11-02, from the app
phone added 2026-11-02, here
mum added 2026-11-05, here
$ sudo veli set dns adguard
The devices' DNS: adguard. The devices reconnected by themselves; no link changes.
$
  1. 01The line from our site installs Veli and stays on the server as the veli command
  2. 02A new device's link and QR — right in the terminal
  3. 03Answers in plain words: what is wrong and which command to type
One list of devicesEither can updateThe app finds a Veli the command installed

Cheat sheet

Everything you need — one command each

Short commands, answers in plain words. Forgot one? veli help shows them all.

# devices
$ sudo veli add phone

A new device: its link and QR right in the terminal

# devices
$ sudo veli list

Every device, those added from the app too

# devices
$ sudo veli rename phone mum

A new name, the same link — nothing to change on the device

# devices
$ sudo veli remove phone

Take a device off: the others won't notice

# state
$ sudo veli status

Whether Veli works, how many devices are connected, whether there is internet

# state
$ sudo veli doctor

Why a device does not connect — and what to do about it

# state
$ sudo veli update

A new version with a signature check; if it does not work, the previous one comes back

# settings
$ sudo veli set dns adguard

DNS without ads and trackers for every device at once

# settings
$ sudo veli set port 8443

Another port without a reinstall: the keys and devices stay

# moving and removal
$ sudo veli backup

A copy under a password: the server's key and every device

# moving and removal
$ sudo ./veli install --restore veli-backup.vbk

A new server from the copy — the devices work with their own links

# moving and removal
$ sudo veli uninstall

Remove Veli entirely: the server is as it was

Which server will do

An ordinary VPS at any host

The simplest plan is enough: 1 core and 1 GB of memory. The command checks the server before it installs — if something is missing, it says so and installs nothing.

Systems

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

Systems based on Debian and Ubuntu will do too. The CPU: regular (x86-64) or ARM.

Touches only its own

A website or another VPN on the server already? Veli changes nothing that isn't its own, and if port 443 is taken, it takes another.

$ sudo veli uninstall
Veli is removed: the server is as it was before the install.

Updates itself

Once a day, when nobody is connected. The keys, devices and port stay — no link changes.

$ sudo veli update --auto on
Updates itself once a day when nobody is connected.

The server can't reach our site

A server in Russia, for example. Download two files to your computer, move them to the server — and install from them.

$ sudo ./veli install --from …
Done. Veli works on port 443.

Put Veli on your own server

The install line and every command are in the docs. Or let the app install Veli by itself, no terminal needed.