VilaVPN Help Center
Store
1.0.44Checked 2026-10-25

How do I install VilaNet on OpenWrt?

Install the two packages that match your router, then open Network > VilaNet in LuCI to sign in and connect. Back up the router first and confirm its package manager and CPU architecture before downloading anything.

Want the full visual reference? Open the rich VilaNet OpenWrt guide for package-specific instructions, architecture help, screenshots and advanced troubleshooting. This page remains the multilingual safe-start guide.

{% hint style="warning" %} Router changes can interrupt every device on your network. Keep a copy of the router configuration and make sure you can reach LuCI or SSH over the local network before you begin. {% endhint %}

What you need

  • A supported OpenWrt or iStoreOS router
  • OpenWrt 24.x with opkg, or OpenWrt 25.x with apk
  • A configured router root password
  • Administrator access to LuCI and SSH
  • An active VilaVPN account
  • The current VilaNet OpenWrt release

The current public release verified for this guide is v1.0.44.

Back up the router

In LuCI, open System > Backup / Flash Firmware and create a configuration backup. Store the archive somewhere other than the router.

Also record:

  • Router model
  • OpenWrt version
  • CPU architecture
  • Whether the router uses opkg or apk

On an SSH session, these commands show the relevant details:

cat /etc/openwrt_release
command -v opkg || command -v apk
opkg print-architecture 2>/dev/null || apk --print-arch

opkg print-architecture can return more than one line. Use the specific architecture with the highest priority number; ignore all and noarch for the core package. For example, prefer aarch64_cortex-a53 over all when it has the higher priority.

Choose the installation path

Router Files Installation path
iStoreOS vilanet-istore-install_1.0.44.run iStore > Manual Install
OpenWrt 24.x vilanet-core_1.0.44_<arch>.ipk and luci-app-vilanet_1.0.44_all.ipk opkg install
OpenWrt 25.x vilanet-core_1.0.44_<arch>.apk and luci-app-vilanet_1.0.44_noarch.apk apk add

Replace <arch> with the architecture reported by the router. Do not guess based only on the router's marketing name.

Verify OpenWrt 25 downloads

The OpenWrt 25 packages are installed with --allow-untrusted because they are local release files rather than packages from the router's configured repository. Verify their SHA-256 values before copying or installing them.

File Expected SHA-256 for v1.0.44
vilanet-core_1.0.44_aarch64_cortex-a53.apk a8844e65752052b762222d08692fce373a152883e09167e1748673a532c9347f
vilanet-core_1.0.44_aarch64_generic.apk 42b19eed836589393dea4873dfa5cce3a19e1eb282b55b77f73f08b409b9aa5e
vilanet-core_1.0.44_arm_arm926ej-s.apk e277c184d1e6a4af7628ba0a9e57fdf3eba90ee24b0820102191ecc73b4eeab7
vilanet-core_1.0.44_arm_cortex-a7_neon-vfpv4.apk 974b4c34b897abba938d0094582872b62893b7f9eddda97724f254073b97d622
vilanet-core_1.0.44_mipsel_24kc.apk 16a37e175dbcb43e01fe9753140ca385b870f1576298f62c860f61180b66e27c
vilanet-core_1.0.44_x86_64.apk 4fba942067e9538cac72f99c35789242460afbc3f4e274601d8e8e5a74f01f71
luci-app-vilanet_1.0.44_noarch.apk cb2e1fa3cda1e99d1f025bda15534b8572f1173bef5054dd071f48489818509f

On macOS, run shasum -a 256 <filename>. On Linux or the router, run sha256sum <filename>. If either value differs, do not install the files.

Install on iStoreOS

  1. Download vilanet-istore-install_1.0.44.run from the current release.
  2. Open the iStoreOS web interface.
  3. Go to iStore > Manual Install.
  4. Upload the .run installer.
  5. Review the installation result before leaving the page.
  6. Open Network > VilaNet.

Install on OpenWrt 24.x

Download the matching core IPK and the architecture-independent LuCI IPK. Copy them to the router:

scp -O vilanet-core_1.0.44_<arch>.ipk root@<router>:/tmp/
scp -O luci-app-vilanet_1.0.44_all.ipk root@<router>:/tmp/

Install both packages over SSH:

Refresh the package lists first. On a fresh router opkg cannot find the kernel modules that VilaNet depends on until you run opkg update.

opkg update
opkg install /tmp/vilanet-core_1.0.44_<arch>.ipk \
  /tmp/luci-app-vilanet_1.0.44_all.ipk
/etc/init.d/vilanet enable
vilanet version

Install on OpenWrt 25.x

Download the matching core APK and the noarch LuCI APK. Copy them to the router:

scp -O vilanet-core_1.0.44_<arch>.apk root@<router>:/tmp/
scp -O luci-app-vilanet_1.0.44_noarch.apk root@<router>:/tmp/

Install both packages over SSH:

apk add --allow-untrusted --force-non-repository \
  /tmp/vilanet-core_1.0.44_<arch>.apk \
  /tmp/luci-app-vilanet_1.0.44_noarch.apk
/etc/init.d/vilanet enable
vilanet version

The installer removes the LuCI package file from /tmp. To run the command again, copy that file to the router again first.

Sign in and connect

  1. Refresh LuCI after installation.
  2. Open Network > VilaNet.
  3. On Overview, enter the email address and password for your VilaVPN account.
  4. Select Login.
  5. Under Quick Actions on the same page, leave Server on Auto - All Servers for the first connection, or choose a specific server. The Servers tab also has a Connect button for each server.
  6. Select Connect.

VilaNet login form in the real OpenWrt LuCI interface using a synthetic example address

This real LuCI capture uses the reserved example address you@example.com and an empty password field. The wide router screen was cropped to keep the login controls legible on a phone; no interface elements were reconstructed.

Physical-router screenshots and a LAN traffic check remain the publication evidence gate; a connected label alone is never tunnel proof.

Confirm it works

Check the router first:

vilanet version
vilanet status --json
/etc/init.d/vilanet status
logread | grep vilanet

Then use a device connected to the router:

  1. Open a normal HTTPS website.
  2. Return to Network > VilaNet > Overview.
  3. Confirm that VPN Service still shows running and Connection still shows connected.

A connected label alone is not enough. Router status and traffic from a LAN device must both work.

If the VilaNet menu is missing

  1. Hard-refresh the LuCI page.
  2. Run /etc/init.d/rpcd restart over SSH.
  3. Reopen LuCI and check Network > VilaNet.
  4. Confirm both the core and LuCI packages are installed.

If VilaNet starts and then stops

Preserve the evidence before reinstalling:

vilanet version
vilanet status --json
/etc/init.d/vilanet status
logread | grep vilanet

Include the router model, OpenWrt version, package manager and the redacted output when contacting support. Do not send your password or raw subscription data.

Unsupported old installer

The old vilanet-test-*.tar.gz manual-copy method is retired. Use the current IPK, APK or iStoreOS installer from the official release.

Next step

Read Recovery and rollback before changing routing mode, upgrading packages or removing VilaNet.

Was this page helpful?