Install Vimify on MikroTik with RADIUS.

1. 01

   Linux gateway

   Download and install Vimify Edge

   Open the Linux terminal. Node.js 20 or newer must already be installed.

   Ubuntu / Debian terminalCopy commands

   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

2. 02

   Linux gateway

   Add enrollment and RADIUS settings

   Replace every placeholder in the configuration file. Set VIMIFY_RADIUS_CLIENTS to the MikroTik LAN IP and use the same secret you will paste into RouterOS.

   Save configuration and startCopy commands

   sudo nano /etc/vimify-edge.env
   sudo systemctl enable --now vimify-edge
   sudo systemctl status vimify-edge

3. 03

   MikroTik RouterOS

   Configure RADIUS and the captive portal

   Open Terminal in WinBox/WebFig or connect by SSH. Change the first four values, confirm the HotSpot profile name with /ip hotspot profile print, then paste the full block.

   RouterOS terminalCopy commands

   :local edgeIp "192.168.88.2"
   :local radiusSecret "CHANGE_TO_YOUR_RADIUS_SECRET"
   :local hotspotProfile "hsprof1"
   :local hotspotId "hotspot-kla-central"
   
   /system backup save name=before-vimify
   /radius remove [find where comment="Vimify Edge"]
   /radius add service=hotspot address=$edgeIp secret=$radiusSecret authentication-port=1812 accounting-port=1813 timeout=3s require-message-auth=yes-for-request-resp comment="Vimify Edge"
   /ip hotspot profile set [find where name=$hotspotProfile] use-radius=yes radius-accounting=yes radius-interim-update=5m login-by=mac,http-pap mac-auth-mode=mac-as-username-and-password radius-mac-format=XX-XX-XX-XX-XX-XX
   /ip hotspot walled-garden remove [find where comment="Vimify Cloud"]
   /ip hotspot walled-garden add dst-host=vimify.ug action=allow comment="Vimify Cloud"
   :local templateUrl ("https://vimify.ug/api/v1/edge/mikrotik/login-template?hotspot=".$hotspotId)
   /tool fetch url=$templateUrl dst-path="hotspot/login.html" mode=https

   These commands create a backup, add Vimify as the HotSpot RADIUS service, keep Message-Authenticator protection enabled, allow the cloud portal before login, and install the matching captive login page.
4. 04

   Verification

   Confirm the first connection

   Join the hotspot with a phone. The Vimify portal should open, pass the phone’s MAC address to the cloud, and return the approved device to the router for local RADIUS authentication.

   RouterOS health checksCopy commands

   /radius monitor [find where comment="Vimify Edge"]
   /ip hotspot active print
   /log print where topics~"radius|hotspot"

   ✓ RADIUS monitor shows requests and accepts✓ Active user is marked as a RADIUS session✓ Vimify Edge reports healthy cloud sync✓ The TID remains only in Vimify Cloud

RouterOS references: RADIUS, HotSpot, and captive portal customization.