VVimifyMikroTik guide

Vimify Edge · Other routers

Connect another RADIUS hotspot.

Install the same Vimify Edge gateway, then follow the setup path for your router or controller. Voucher and Mobile Money records remain in Vimify Cloud.
Choose a device ↓Download Edge 0.3
UniFiOmadapfSenseOpenWrtAll connect to one private Vimify Edge RADIUS gateway.

Step one for every router

Install Edge on the Linux gateway

Use Ubuntu or Debian with Node.js 20 or newer. Set VIMIFY_RADIUS_CLIENTS to the router or controller IP and keep UDP 1812/1813 on the private network.
Linux terminalDownload package
curl -fL https://vimify.ug/downloads/vimify-edge-0.3.0.tar.gz -o vimify-edge.tar.gz
mkdir -p vimify-edge
tar -xzf vimify-edge.tar.gz -C vimify-edge
cd vimify-edge
sudo ./install.sh
sudo nano /etc/vimify-edge.env
sudo systemctl enable --now vimify-edge
01 · Controller setup

UniFi Network

Use a UniFi Console, CloudKey, or self-hosted Network application to point the guest hotspot at Vimify Edge.

External RADIUS
  1. Open the site settings and create an external RADIUS profile. Use the Linux gateway IP, authentication port 1812, accounting port 1813, and the Vimify RADIUS secret.
  2. Open Settings → WiFi, select the guest SSID, and enable Hotspot Portal → Captive Portal.
  3. Open Insights → Hotspot → Landing Page and choose RADIUS (advanced). Enable accounting and use a five-minute interim interval where available.
  4. Allow the Vimify cloud hostname before authentication, then connect a test phone and confirm its Calling-Station-Id reaches Edge.

UniFi menu names can differ by Network version. RADIUS connectivity works now; the account-free Mobile Money return flow needs the UniFi external-portal connector before a commercial rollout.

Open official guide ↗
02 · Controller setup

TP-Link Omada

Keep the Omada Controller online and use its External RADIUS portal mode with Vimify Edge on the same private network.

External RADIUS
  1. In the selected site, open Settings → Authentication → Portal and create a portal for the hotspot SSID or LAN network.
  2. Choose External RADIUS Server. Set the authentication server to the Edge gateway on UDP 1812 and accounting to UDP 1813.
  3. Enter the same shared secret used in /etc/vimify-edge.env, enable RADIUS accounting, and set interim updates to five minutes.
  4. Add the Vimify cloud hostname to pre-authentication access and verify the controller sends clientMac or Calling-Station-Id with each request.

Omada requires its controller to remain online for portal authentication. The fully automatic payment return will use Omada’s browserauth external-portal endpoint in the dedicated adapter.

Open official guide ↗
03 · Firewall setup

pfSense / Netgate

pfSense can authenticate the device MAC through Vimify Edge and send start, interim, and stop accounting records.

RADIUS MAC
  1. Open System → User Manager → Authentication Servers and add a RADIUS server using the Edge gateway IP, UDP 1812/1813, and the shared secret.
  2. Open Services → Captive Portal, create or edit the guest zone, select the guest interface, and enable RADIUS MAC Authentication.
  3. Choose the Vimify authentication and accounting server, keep the default colon-separated MAC format, and enable interim accounting updates.
  4. Add the Vimify cloud hostname under Allowed Hostnames, then check Status → Captive Portal while testing from a phone.

RADIUS MAC authentication is supported by Vimify Edge. A Vimify pfSense portal template is still needed to hand the customer’s device into the cloud payment page automatically.

Open official guide ↗
04 · Terminal setup

OpenWrt + CoovaChilli

Use CoovaChilli as the captive-portal network access server and keep Vimify Edge on a separate Linux gateway when possible.

RADIUS gateway
  1. Connect by SSH, update the OpenWrt package list, and install the CoovaChilli package supported by the router’s release and architecture.
  2. Configure the primary RADIUS and accounting server as the Edge gateway, using UDP 1812/1813 and the same shared secret.
  3. Set the hotspot LAN interface, UAM network, DNS, and the Vimify hostname in the allowed pre-authentication domain list.
  4. Restart CoovaChilli and follow its log while a phone joins. Confirm the request includes the customer device MAC as Calling-Station-Id.

OpenWrt packages and CoovaChilli options vary by firmware and available storage. Confirm the package exists for the exact router before changing a live hotspot.

Open official guide ↗

Any other RADIUS device

Use the generic checklist

AuthenticationEdge gateway · UDP 1812AccountingEdge gateway · UDP 1813IdentitySend client MAC in Calling-Station-IdProtectionPrivate LAN or site-to-site VPN only

If your router has external RADIUS and exposes the customer MAC address, Vimify can add a device adapter without moving vouchers or TIDs onto the router.