For VPN services

Your VPN service on Veli

Your own panel on your server: clients, terms, nodes in different countries. Each client gets one link and connects in the Veli app — over the Veli protocol and the usual protocols.

What's inside

Everything a VPN service runs on

The panel keeps the clients and the nodes. Your shop, bot and client area you connect to it yourself — through the API, webhooks or an AI agent.

Clients and terms

Each client has a term, a number of devices and a traffic limit. Extend it — the link stays the same; when the term runs out, the nodes stop letting the client in by themselves.

ClientLeftStatus
  • anna28 daysactive
  • order-881232 daysexpiring
  • team-kz14 daysout of traffic
  • gift-041230 daysnot connected yet
$ sudo veli users add anna --days 30 --devices 3

Nodes in different countries

A new node is one command: it logs in to the server over SSH, installs Veli and the protocols you want, and connects the node to the panel. Clients get it on their own.

  • de-1

    Frankfurt

    online
  • nl-1

    Amsterdam

    online
  • fi-1

    Helsinki

    online
  • pl-1

    Warsaw

    online
  • tr-1

    Istanbul

    online
  • kz-1

    Almaty

    online

Next to Veli — if you want

VeliRealityTrojanShadowsocksVMessHysteria2TUIC
$ sudo veli nodes add de-1 --ssh root@203.0.113.5

One link per client

One link to all nodes, with a QR code. In Veli it gives the Veli protocol and the usual ones; in other apps the same link gives the usual ones.

https://panel.example.com/s/kV0q7Xr2

VeliHappv2rayNGHiddify

Webhooks

The panel tells your system itself: a client was added, a term is running out, a node went silent. Every request is signed.

POST bot.example.com/veli/events
veli-event: client.expiring
veli-signature: t=1762190000,v1=5cfa…

{"event": "client.expiring",
 "data": {"client": {…}, "days": 3}}

An API for your shop

Your site, bot or client area creates and extends clients with a token. A repeated request with the same key won't create a second client.

curl "$VELI/clients" \
  -H "Authorization: Bearer $VELI_TOKEN" \
  -H "content-type: application/json" \
  -H "Idempotency-Key: order-88123:new" \
  -d '{"name": "order-88123", "days": 30}'
200
{"done": 1, "client": {"name": "order-88123", "status": "on", …}}

MCP for an AI agent

The agent runs the panel through the same API, with the same token rights. It can't see clients' links.

Morning round
morning_round
3 clients are expiring, one is out of traffic. Node fi-1 was silent for 4 minutes and is online now.
Extend order-88123 by 30 days
Done: order-88123 runs until December 18.

Moving from another panel

Clients move over with their terms, limits and devices. Without --yes the command only checks.

RemnawaveMarzban3x-uiHiddifyCSVYour panel
$ sudo veli panel import marzban https://old.example.com --user admin --password -

Getting started

Three commands to your first client

You need two Linux servers: one for the panel, the other as a node.

  1. 1

    Set up the panel

    Point a domain at the panel's server — the certificate is issued automatically.

    $ sudo ./veli panel install --domain panel.example.com
  2. 2

    Add a node

    The command logs in to the node's server over SSH and connects it.

    $ sudo veli nodes add de-1 --ssh root@203.0.113.5
  3. 3

    Create a client

    The command prints a link and a QR code — send them to the client.

    $ sudo veli users add anna --days 30 --devices 3

Free

We don't sell anything

The panel, the nodes and the veli command are free: no licences and no limits on clients or devices. You sell subscriptions to your clients — at your prices, with your own client area and payments.

  • No licences
  • No limits on clients
  • The servers are yours

Start with one server

Set up the panel, add a node and send the client a link. All the commands are in the docs.