SmartFi
Setup guide

Get your SmartFi Vendo running

Step-by-step from unboxing to first paying customer. Start with the requirements below, then follow each step in order.

Requirements

The recommended path is the SmartFi Starter Kit, which comes with the validated hardware ready to register. If you already have your own hardware, the lists below tell you what works.

Hardware

🛜
Router
MikroTik hEX RB750Gr3

Validated for v1. Other models can be tried but will be tagged experimental until tested.

📡
Wireless Access Point
TP-Link EAP110

Other APs (Comfast, newer EAP variants, etc.) can be selected as “Other” during registration. They are tagged experimental until validated.

🪙
Coin Acceptor + NodeMCU
NodeMCU ESP8266 with SmartFi firmware + a compatible coin acceptor (CH-926 / JY-925 class)

Pre-flashed in the SmartFi Starter Kit. Self-flashing is supported via the WebSerial flasher in the dashboard.

🌐
Internet Connection
Any ISP — fiber, DSL, Starlink, 5G

On Starlink (or any plan with a monthly data cap) you can use SmartFi’s Internet Plan tracker to avoid going over your Priority data.

🔌
Power & Cabling
Power supply per device + at least 2 Ethernet cables (CAT5e or better)

One cable for router → AP, one for router → NodeMCU. A UPS is recommended for areas with frequent power cuts.

Screenshot placeholder — Starter Kit photo (router + AP + NodeMCU + coin acceptor)

Software, OS & Browser

🛰
Router (hEX)
RouterOS 7.1 or higher (mmips bundle)

RouterOS 6 is not supported. If your hEX is on v6, upgrade before registration. Brand-new routers running RouterOS 7.13 or newer need a one-time device-mode unlock — Step 5 walks you through it.

🖥
Dashboard Browser
Chrome 100+ · Edge 100+ · Safari 15+ · Firefox 100+

The WebSerial flasher (for self-flashing the NodeMCU) requires Chrome or Edge on a desktop.

📱
Test Phone
Android 10+ · iOS 14+

Older versions may not show the captive-portal pop-up correctly when testing.

👤
SmartFi Account
Free signup with email verification

A payment method (GCash, Maya, or card via Xendit) is needed when buying credits to activate a device.

Screenshot placeholder — SmartFi dashboard view in browser

Setup steps

Nine steps from unboxing to going live. Most stores get through this in 30–45 minutes the first time.

01

Create your SmartFi account

Sign up at app.smartfi.ph and verify your email. Free — no credit card required for the account itself.

  • Use your real email — verification link is sent there.
  • Google sign-in works too if you’d rather skip a password.
Sign up free
Screenshot placeholder — Step 01: Create your SmartFi account
02

Get your first credit

Every new vendo starts with a 14-day free trial — no credit needed up front. After the trial, one credit keeps your device running for one full year.

  • Trial activates the moment you register your first device. No card on file required.
  • After 14 days, top up with credits to keep going. One credit = one device-year.
  • Buy credits directly from the dashboard, or get them through a SmartFi distributor in your area.
  • Pay with GCash, Maya, QRPH, or card via Xendit. Credits never expire until you activate them on a device.
Screenshot placeholder — Step 02: Get your first credit
03

Connect your hardware

Set up the physical cabling before you open the dashboard wizard. Plug everything in, then power up.

  • ISP (Starlink / fiber / 5G modem) → ether1 on the hEX (WAN).
  • TP-Link EAP110 (or your AP) → any of ether2 to ether5 on the hEX. AP must be in pure bridge mode.
  • NodeMCU + coin acceptor → another ether2–5 port on the hEX.
  • Power on each device. Wait ~60 seconds for the hEX to finish booting.
Screenshot placeholder — Step 03: Connect your hardware
04

Register your device in the dashboard

In the SmartFi dashboard, open the Register Device wizard. The wizard walks you through naming your store, picking your hardware, and flashing the NodeMCU.

  • Pick router model (hEX RB750Gr3 is the validated default).
  • Pick AP model — TP-Link EAP110 if you’re on the Starter Kit, or “Other” with the exact brand/model if you’re using your own.
  • Flash the NodeMCU with the WebSerial flasher (Chrome or Edge desktop). Skipped if you got a pre-flashed Starter Kit.
  • Enter the SSID you want customers to see.
Screenshot placeholder — Step 04: Register your device in the dashboard
05

Prepare your router (one-time setup)

New MikroTik routers ship with some commands locked at the OS level. Run this one-time unlock before pasting the SmartFi script. If your router is already unlocked, running it again is safe — it does nothing.

  • Open Winbox, log in to your hEX, and open the Terminal from the side menu.
  • Paste this single command: /system device-mode update mode=advanced
  • Within 60 seconds: unplug your router, wait 3 seconds, plug it back in. This power-cycle is MikroTik’s physical-confirmation step.
  • Once the router boots back up, reconnect to Winbox. You’re ready for the next step.
  • Why is this needed? MikroTik introduced a security feature in late 2023 (RouterOS 7.13) that ships new routers in a restricted home mode where the hotspot service, the file fetch tool, and the scheduler are blocked. SmartFi needs all three. Switching to advanced mode unlocks them.
Screenshot placeholder — Step 05: Prepare your router (one-time setup)
06

Connect your router to SmartFi

When the wizard generates a custom RouterOS script for your device, paste it into the hEX terminal. The script sets up the hotspot, captive portal, walled garden, IPv6 protection, and SmartFi-specific firewall rules — all in one go.

  • Open Winbox or WebFig on the hEX. Paste the entire script into the terminal.
  • The script is idempotent — re-running it on a partly-configured router won’t double up resources.
  • After paste, the hEX should appear as Online in your dashboard within ~30 seconds.
Screenshot placeholder — Step 06: Connect your router to SmartFi
07

Set the SSID on your access point

The router script runs on the hEX, but the AP broadcasts the WiFi name (SSID). Log in to your AP and set the SSID to the one you entered in Step 4.

  • For TP-Link EAP110: open its admin page in your browser. Set SSID, then put the AP in bridge mode.
  • For other APs: same idea — pure bridge mode, no NAT, no DHCP.
  • Match the SSID you entered during registration so customers see the right name.
Screenshot placeholder — Step 07: Set the SSID on your access point
08

Test with a phone

Take a phone, forget any old WiFi networks, and connect to your new SSID. The SmartFi captive portal should pop up automatically.

  • On Android: the login page usually opens by itself within a few seconds.
  • On iOS: tap the WiFi name; the captive portal sheet should appear.
  • Drop a real coin (or enter a voucher) to confirm the full flow works end-to-end.
Screenshot placeholder — Step 08: Test with a phone
09

You’re live

Your vendo is now ready for paying customers. Watch sales, device health, and customer sessions from the SmartFi dashboard in real time.

  • Open the Device Health tab any time to check internet, heartbeat, NodeMCU and DHCP status.
  • If something breaks, the Self-Fix Guide tells you exactly which part needs attention.
Screenshot placeholder — Step 09: You’re live
Stuck on a step? Open the Device Health tab in your dashboard — the Self-Fix Guide will tell you which part isn’t talking yet. If you’re still stuck, send us a message with your device ID and we’ll take a look.