MikroTik Setup

Connect CaptiFi to your MikroTik router or access point using the built-in Hotspot feature.

Advanced Setup

MikroTik integration requires some networking knowledge. If you're not comfortable with RouterOS, consider using a CaptiFi plug-and-play device instead.

Prerequisites

• MikroTik device running RouterOS 6.x or 7.x
• Access to WinBox or WebFig
• CaptiFi account at app.captifi.io

Step 1: Create a Hotspot

1. Open WinBox or WebFig
2. Go to IP → Hotspot
3. Click Hotspot Setup wizard
4. Select the interface for your guest WiFi
5. Set the network address (e.g., 10.5.50.1/24)
6. Set the address pool
7. Choose SSL certificate: none (CaptiFi handles this)
8. Set SMTP server: 0.0.0.0
9. Configure DNS: use your ISP or 8.8.8.8
10. Set DNS name: e.g., hotspot.local

Step 2: Configure Walled Garden

Allow CaptiFi portal domains through the firewall before authentication:

1. Go to IP → Hotspot → Walled Garden
2. Add entries to allow:

Action	Dst. Host
Allow	*.captifi.io
Allow	app.captifi.io
Allow	*.stripe.com

3. Also add Walled Garden IP List entries for CaptiFi server IP

Step 3: Configure RADIUS

1. Go to RADIUS in the main menu
2. Click Add
3. Configure:
   • Service: hotspot
   • Address: (provided by CaptiFi — contact support)
   • Secret: (provided by CaptiFi)
   • Authentication Port: 1812
   • Accounting Port: 1813
4. Enable Use RADIUS in Hotspot Server Profile

Step 4: Set External Login Page

1. Go to IP → Hotspot → Server Profiles
2. Edit your profile
3. Set Login By: HTTP PAP
4. Under the Login tab, set the login page URL to your CaptiFi portal URL (provided during setup)

Step 5: Link in CaptiFi Dashboard

1. Log in to app.captifi.io
2. Go to Settings → Integrations
3. Select MikroTik
4. Enter your MikroTik's public IP and credentials
5. Click Connect

Step 6: Test

1. Connect a device to the guest WiFi
2. Verify the CaptiFi splash page appears
3. Complete a test login
4. Check the CaptiFi dashboard for the entry

Troubleshooting

Issue	Solution
Splash page not loading	Check Walled Garden entries
"Access denied" after login	Verify RADIUS secret matches
Guests stuck on loading	Check DNS configuration
No entries in dashboard	Verify RADIUS accounting is enabled

Need Help?

MikroTik setups can be tricky. Contact us at hello@captifi.io and we'll walk you through it.