← All devices

Full Node · Setup guide

MikroTik Router (RouterOS)

MikroTik is the gold-standard router for EZLINK because it has a built-in 'hotspot' feature with a walled garden. We'll paste a small script into your router so it talks to EZLINK.

Is this router in a hotel, office, coworking space or campus?

Corporate venues should use the hosted RADIUS bridge instead of configuring a standalone hotspot. Same hardware, no laptop agent, works with your fiber/business ISP.

Switch to the RADIUS onboarding path

Start here

Sign in, accept the short Host Agreement, and we'll generate your Node ID + Token (and the installer, if there is one) on the spot.

Download this guide as PDF

Before you start, you need:

  • A MikroTik router running RouterOS 7.0 or newer.
  • Admin access to the router (you know the admin password).
  • A computer on the same network as the router.

Step by step

  1. 1

    Sign in & accept the Host Agreement

    Click Get my setup script below, sign in, accept the agreement. We'll generate a script with your Node ID already baked in.

  2. 2

    Open WinBox (or the web interface)

    WinBox is the free tool for managing MikroTik routers. Download it from mikrotik.com if you don't have it. Open it, type the router's IP (usually 192.168.88.1), your username (usually 'admin'), and your password, and click Connect.

  3. 3

    Open the Terminal inside WinBox

    In the left sidebar of WinBox, click New Terminal. A black command window opens — this is where the script goes.

  4. 4

    Paste the script we gave you

    Copy the EZLINK setup script from the box below. In the Terminal window, right-click → Paste. Press Enter. You'll see lines fly by — that's normal. When it stops, the prompt comes back.

    Tip: If you see 'failure: already have' messages, ignore them — that means the hotspot was already partly configured, and the script skipped those bits.

  5. 5

    Activate the EZLINK agent on the router

    The script already embedded your Node ID and Token, so activation is automatic — but you can verify it. In the same WinBox Terminal, type: /system scheduler print and you should see an 'ezlink-heartbeat' job. To force an immediate check-in, type: /system script run ezlink-register . You'll see 'status=registered' if the router reached EZLINK successfully.

    Tip: If you ever rotate your Node Token in the Owner dashboard, re-run the setup script — the router will pick up the new token and re-activate.

  6. 6

    Confirm in Owner → My Nodes

    Come back to this website and open Owner → My Nodes. Within about a minute, your MikroTik node should flip to 'online' with a green dot. Click it to see live client count and uptime.

How you'll know it worked

  • Your router shows up as 'online' in EZLINK within 60 seconds.
  • Connecting a test phone to the new Wi-Fi opens the EZLINK captive portal automatically.

If something goes wrong

Node never appears online

Re-run the script. Check that the router can reach the internet (try /tool fetch url=https://ezlinkapp.net in the terminal).

Captive portal doesn't appear on test phone

Turn the phone's Wi-Fi off and on. If still nothing, double-check the hotspot is on the right interface (usually wlan1).

Ready to go?

Click below to get your credentials.