Setup Guide

MikroTik Captive Portal
Setup Guide

Point your MikroTik RouterOS hotspot at CaptiFi's external splash page to capture guest emails, automate Google reviews and run marketing on autopilot. Or skip the config entirely with our free plug-and-play device.

๐Ÿ“‹ Before you start, make sure you have:
โ€ข A MikroTik router running RouterOS with internet access
โ€ข Admin access to RouterOS via WinBox, WebFig or the terminal
โ€ข A CaptiFi account - create one here
โ€ข Your splash page URL from the CaptiFi dashboard

1 3-step setup overview

Setting up CaptiFi on MikroTik follows the same external-splash flow as every other vendor we support. There are three jobs:

Step 1 Enable the RouterOS hotspot on the interface that serves your guests.
Step 2 Point the hotspot login at the CaptiFi external splash URL.
Step 3 Add the CaptiFi domains to the hotspot walled garden so the splash page loads before sign-in.
๐Ÿ’ก MikroTik keeps routing your traffic. CaptiFi only adds the branded splash page, the email capture, the GDPR consent and the marketing automation that follows.
โš ๏ธ RouterOS exposes hotspot settings under IP โ†’ Hotspot, but exact menu wording varies by RouterOS version. If you would rather not configure RouterOS by hand, our free plug-and-play device skips all of this. See the section below.

2 Enable the RouterOS hotspot

In WinBox or WebFig, open IP โ†’ Hotspot and run the hotspot setup on the interface your guests connect to (for example the bridge that carries your guest WiFi). RouterOS will create the hotspot server, an IP pool and a DHCP scope for that interface.

Hotspot interface The bridge or interface serving guest WiFi
Address pool Keep the default RouterOS suggests for the hotspot
Login method HTTP / HTTPS redirect to an external server
๐Ÿ’ก If you already run a guest network on the router, attach the hotspot to that interface rather than creating a new one.

3 Point the hotspot at CaptiFi

RouterOS supports redirecting unauthenticated guests to an external login page. Set the hotspot login page to redirect to your CaptiFi splash URL so guests see your branded portal instead of the default RouterOS login.

External login Redirect unauthenticated users to your CaptiFi splash URL
Splash page URL Use the exact URL shown in your CaptiFi dashboard for this location
โš ๏ธ Use the exact splash URL from your CaptiFi dashboard. Do not shorten it or strip query parameters, or the portal will not match the guest session correctly.

4 Add the walled garden domains

The hotspot blocks everything until a guest signs in, so the splash page itself needs an exemption. Under IP โ†’ Hotspot โ†’ Walled Garden, add each of these domains:

๐Ÿ’ก Add one walled garden entry per domain, then apply. Without these, the splash page cannot load before the guest is authenticated.

5 Test the solution

Connect a phone to your guest WiFi. You should be redirected to your branded CaptiFi splash page. Enter a test email, complete the login, and confirm you reach the internet.

Verify the capture in your CaptiFi dashboard under Site Guest Logs.

โœ… Your CaptiFi captive portal is now running on your MikroTik hotspot. Every guest who connects sees your branded login page and their email is captured automatically.
๐Ÿงญ Want the detailed RouterOS walkthrough? The blog guide below carries the step-by-step hotspot and walled garden configuration with the exact RouterOS settings.

Works with your existing MikroTik kit, or use our free device

You do not have to buy anything new, and you do not have to learn RouterOS. There are two paths and both are included with your plan.

Use your existing MikroTik kit If you are comfortable in RouterOS and already run a MikroTik router, follow the steps above. CaptiFi sits in front as the external splash. No extra hardware.
Use our free plug-and-play device RouterOS is powerful but fiddly. If you would rather not touch WinBox, we post you a pre-configured CaptiFi device. Plug it into your existing network by Ethernet, it pulls its config from the cloud, and a guest SSID appears in about two minutes. No hotspot config, no walled garden, no static IP.
๐Ÿ’ก The plug-and-play device is the zero-config alternative, and it is the path most MikroTik venues choose. Same marketing platform either way.

Related guides and pages

MikroTik captive portal FAQ

Does CaptiFi work with the RouterOS hotspot?

Yes. CaptiFi runs as an external splash page behind the RouterOS hotspot. You enable the hotspot, redirect unauthenticated guests to the CaptiFi URL, and add our domains to the walled garden. If you would rather skip RouterOS entirely, use our free plug-and-play device.

I am not comfortable in RouterOS. Is there an easier way?

Yes, and most venues take it. Our free plug-and-play device needs no RouterOS configuration at all: plug it into your network by Ethernet and a branded guest SSID appears in about two minutes.

Why is my MikroTik splash page not loading?

Almost always the walled garden is missing a CaptiFi domain, so the router blocks the splash page before the guest can sign in. Confirm all four domains are added under IP, Hotspot, Walled Garden, and test on a device that has not cached a previous portal.

Will CaptiFi slow down my MikroTik network?

No. CaptiFi only handles the sign-in splash page. Once a guest is authenticated, their traffic is routed by RouterOS as normal. Throughput is unaffected.

Can I keep my existing MikroTik guest network?

Yes. You attach the hotspot to your existing guest interface rather than rebuilding the network. Your routing, firewall and other interfaces stay as they are.

Is MikroTik hotspot email capture GDPR compliant with CaptiFi?

Yes. CaptiFi captures guest details with clear consent and keeps a full audit trail, so the email capture on your MikroTik hotspot stays UK GDPR and PECR compliant.

Turn your MikroTik guest WiFi into a marketing machine

Start a free 30-day trial, or watch a live demo first. No credit card needed.