Documentation/Connecting/Router·1 / 4

Veli on a router

The whole home through Veli on one router: the TV, the set-top box, the console and smart devices. What is supported, how to install it, how to choose devices and how to remove it.

How it works

  • The whole home through Veli — Veli is installed on the router, and the TV, the set-top box, the console and the smart devices that cannot run the app go out through Veli. You enter the link of your Veli server or a subscription on the router once.
  • You choose who goes — Send the whole home through Veli, only some devices, or everyone but some. The TV through Veli, the banking app direct.
  • Your country's sites direct — The sites and services of your own country can stay off Veli: they open as usual and do not take you for a visitor from abroad.
  • If a server stops answering — The router moves to another server of the subscription by itself, one of the same country first. While it moves, the home does not get out round Veli: the internet is gone for a moment, never open and unprotected.

What is supported

Firmware

OpenWrt 24.10
An .ipk package, the opkg manager.
OpenWrt 25.12
An .apk package, the apk manager.
OpenWrt 22.03 and 23.05
The same .ipk package.
OpenWrt 21.02
The same .ipk package. Its firewall is the old one (iptables) — Veli puts the rules for it in by itself.
ImmortalWrt 24.10
The same .ipk package.

On each one we checked the install, your own server's link and a subscription, connecting, moving to another server, a reboot, an update and the removal. The settings page is in LuCI, “Services → Veli”, in English, Russian, Chinese and Arabic.

Processors

Veli is built for four kinds of processors. The models are examples: check that yours has 16 MB of flash and 64 MB of memory or more (below, “What you need”).

  • 64-bit ARMaarch64

    Most Wi-Fi 6 routers of recent years.

    Chips:
    MediaTek MT7981 and MT7986 (Filogic), Qualcomm IPQ807x, Rockchip
    For example:
    GL.iNet GL-MT3000 and GL-MT6000, Xiaomi AX3000T, Cudy WR3000, Xiaomi AX3600, NanoPi R4S
  • 32-bit ARM with an FPUarmv7

    Mid-range and high-end Wi-Fi 5 routers.

    Chips:
    Qualcomm IPQ40xx and IPQ806x, MediaTek MT7623, Marvell Armada 38x
    For example:
    GL.iNet GL-B1300, ASUS RT-AC58U, Netgear R7800, Linksys WRT3200ACM, Turris Omnia
  • MIPS little-endianmipsel

    Budget Wi-Fi 5 and Wi-Fi 4 routers.

    Chips:
    MediaTek MT7621, MT7620, MT7628 and MT7688
    For example:
    Xiaomi Mi Router 4A Gigabit and 3G, Xiaomi Redmi AC2100, Netgear R6220, GL.iNet GL-MT300N-V2
  • x86-64x86_64

    A router made of a mini PC or an old computer.

    Chips:
    Intel and AMD
    For example:
    a mini PC with two network ports, an old computer, a virtual machine with OpenWrt

Will not do

  • MIPS big-endian — Atheros and Qualcomm Atheros (ath79), Lantiq, Realtek — most older TP-Links run on them, such as the Archer C7 and Archer C6 v2.
  • ARM without an FPU — Broadcom BCM4708 and BCM4709 (for example, Netgear R7000 and ASUS RT-AC68U) and MediaTek MT7629.
  • 8 MB of flash or less — Veli and its dependencies will not fit.
  • Other firmware — Keenetic and Netcraze (through Entware), MikroTik, ASUS with Merlin and factory firmware are not supported yet. If your model is in the table of hardware on openwrt.org, OpenWrt can go on it.

How to tell your processor

In LuCI open “Status → Overview”: it has the “Model” and “Architecture” rows. Most precisely — over SSH:

the DISTRIB_ARCH line: aarch64_… — 64-bit ARM; arm_… ending in vfp or neon — 32-bit ARM with an FPU; a bare arm_cortex-a9 or arm_cortex-a7 — no FPU, will not do; mipsel_… — MIPS little-endian
cat /etc/openwrt_release

The app and the install command check this themselves: if there is no Veli for the router, they say so without changing anything.

What you need

  • A router running OpenWrt, and SSH access to it: OpenWrt has it on from the start. The router must reach velivpn.com: Veli and its updates install from our repository.
  • The link of your Veli server (in the app: Own server → Add a device) or the address of your VPN service's subscription that has Veli servers in it.
  • 16 MB of flash or more: Veli with what it needs takes up to 4.5 MB, and less on routers whose flash is compressed.
  • Memory: 64 MB at least, 128 MB is better.
  • The right time. Many routers have the wrong time after power-up until a time server answers; Veli waits for it by itself, and the home stays without internet in the meantime, not without protection.

Installing from the app

Veli goes on in one of three ways: from the app on a computer, in one command or by hand. All three put the same thing on, from our repository, like any OpenWrt package: what it needs comes with it, its updates come with the other packages', and the router checks the signature of each package itself. The easiest is the app: it signs in to the router, installs Veli and connects it. The computer has to be on this router's network.

  1. 01

    Open “Add” → “Router”

    In “Profiles”, press “Add” and pick “Router”.

  2. 02

    Sign in to the router

    “Router address” is the same as its page's in the browser, usually 192.168.1.1. “root password” is the password of the router's page; a freshly flashed OpenWrt has none, and the field stays empty. You can also sign in “With an SSH key”. Press “Continue”.

    At first the app only looks: that the router runs OpenWrt and that there is Veli for its processor. Nothing changes on the router before “Install”.

  3. 03

    Choose what it connects by

    The app offers what it already has:

    • your server with Veli: the router gets a device of its own on it;
    • a subscription from “Profiles”: the provider sees the router as a device of its own;
    • “Another link or subscription”: paste your server's veli://… link or a subscription's address.
  4. 04

    Press “Install”

    The app adds the repository, installs Veli with its settings page in the app's language, hands the router the link or the subscription and starts Veli. The steps go by as a list; the window can be closed and the install goes on. The whole home goes through Veli; who goes is set later.

  5. 05

    The router is a row in “Profiles”

    The router stands under your servers. In place of “Connect” the row says what it is doing now: “Whole home · server”, “Connecting…” or “Not answering”. “Open” leads to the router's screen.

The router's screen

The router's screen in the app
  • State — Whether the home goes through Veli, on which server, and which Veli is on the router. At the top, “Router's page”: its web interface in the browser.
  • What the router connects by — Your server, a subscription or a link. “Change” takes another one, and the router connects anew. A subscription has the choice of its server beside it: one from its list or “The first that answers”.
  • Who goes through Veli — “The whole home”, “Only the ones chosen” or “All but the ones chosen”. The devices are those the router has given an address to, or type an address yourself.
  • Sites of the home country straight out — Sites of your own country open without VPN. The router takes changed settings with the “Apply” button.
  • “…” — “Rename”, “Change the password or key”, “Update Veli” and “Remove from the router”.