Documentation/Connecting/Router/Installing in one command·2 / 4

Installing in one command

In the router's SSH. Before it changes anything, the command checks that this is OpenWrt 21.02 or later, or ImmortalWrt, that there is Veli for the router's processor and that the router has room for it. Run again, it updates Veli.

install; the settings page speaks the language of the router's web interface
wget -O- https://velivpn.com/routers/install.sh | sh
the settings page in English; ru for Russian, zh-cn for Chinese, ar for Arabic
wget -O- https://velivpn.com/routers/install.sh | sh -s -- --lang en
take Veli off and put the router back as it was
wget -O- https://velivpn.com/routers/install.sh | sh -s -- remove

Then enter the link or the subscription and switch Veli on: on the Services → Veli page in LuCI, or with the commands of steps 3 and 4 below.

Installing by hand

What the command does, step by step, in the router's SSH.

  1. Add Veli's repository

    The key it is signed with, and its address for your router's processor: the line puts that in itself. From then on a package changed on its way does not install.

    OpenWrt 21.02–24.10, ImmortalWrt: the key
    wget -O /tmp/veli-opkg.pub https://velivpn.com/routers/keys/veli-opkg.pub &&
      opkg-key add /tmp/veli-opkg.pub
    OpenWrt 21.02–24.10, ImmortalWrt: the address
    . /etc/openwrt_release &&
      echo "src/gz veli https://velivpn.com/routers/ipk/$DISTRIB_ARCH" >> /etc/opkg/customfeeds.conf
    OpenWrt 25.12: the key
    wget -O /etc/apk/keys/veli.pem https://velivpn.com/routers/keys/veli.pem
    OpenWrt 25.12: the address
    . /etc/openwrt_release &&
      echo "https://velivpn.com/routers/apk/$DISTRIB_ARCH/packages.adb" >> /etc/apk/repositories.d/customfeeds.list
  2. Install it

    Veli and the page for LuCI. For the page in Russian, Chinese or Arabic, add its translation: luci-i18n-veli-ru, -zh-cn or -ar. Veli stays off for now.

    OpenWrt 21.02–24.10, ImmortalWrt
    opkg update &&
      opkg install veli luci-app-veli
    OpenWrt 25.12
    apk update &&
      apk add veli luci-app-veli
  3. Enter the link or the subscription

    The router tells a link from a subscription by itself. Its keys are made on the router: the subscription's provider gets only the public half.

    your subscription's address, or your server's veli://… link, in place of the dots
    echo 'https://…' | veli-node router set --from -
  4. Switch it on

    The same on the Services → Veli page in LuCI, with a field for the link or the subscription and the choice of the subscription's server.

    switch on
    uci set veli.main.enabled=1 &&
      uci commit veli
    start
    /etc/init.d/veli restart