MikroTik Hotspot Setup Step by Step (Café & Hotel WiFi 2026
Contents
- 1 MikroTik Hotspot Setup Step by Step (Café & Hotel WiFi 2026)
- 2 What You Need Before You Start
- 3 MikroTik Hotspot Setup at a Glance
- 4 Step-by-Step MikroTik Hotspot Setup Guide
- 4.1 Step 1: Connect to Your MikroTik Router via Winbox
- 4.2 Step 2: Assign a LAN IP Address to Your Interface
- 4.3 Step 3: Run the MikroTik Hotspot Setup Wizard
- 4.4 Step 4: Create User Profiles (Bandwidth & Session Limits)
- 4.5 Step 5: Add Hotspot Users
- 4.6 Step 6: Test the Hotspot Login Page
- 4.7 Step 7: Customize the Hotspot Login Page (Captive Portal) — Optional
- 5 Advanced Hotspot Features
- 6 MikroTik Hotspot Troubleshooting
- 7 7 Common Mistakes When Setting Up MikroTik Hotspot
- 8 MikroTik Hotspot for Nepal — Practical Advice
- 9 Key Takeaways
- 10 Frequently Asked Questions
- 10.1 What is a MikroTik Hotspot?
- 10.2 Why is the MikroTik hotspot login page not showing?
- 10.3 How do I limit internet speed per user in MikroTik Hotspot?
- 10.4 Is MikroTik Hotspot completely free?
- 10.5 How many users can MikroTik Hotspot handle at once?
- 10.6 Can MikroTik Hotspot work with an external WiFi access point?
- 10.7 How do I create a custom branded login page for my café?
- 10.8 What is Walled Garden in MikroTik Hotspot?
- 11 Related MikroTik Guides on Madankc.com.np
MikroTik Hotspot Setup Step by Step (Café & Hotel WiFi 2026)
Quick Answer: To set up a MikroTik hotspot, open Winbox → go to IP → Hotspot → Hotspot Setup → select your LAN interface → configure IP pool and DNS → create user profiles with bandwidth limits → add user accounts. Done in under 15 minutes on any RouterOS 6.x or 7.x router.
- Run the Hotspot Setup Wizard in Winbox
- Create bandwidth-limited user profiles for free, basic, and premium tiers
- Add and manage hotspot users
- Customize the captive portal login page
- Set up Walled Garden and MAC bypass
- Troubleshoot all common hotspot problems
- Nepal-specific tips for café and hotel WiFi
Whether you run a café in Kathmandu or a hotel in Pokhara, MikroTik’s built-in Hotspot feature gives you a professional WiFi login system — completely free. Your customers see a branded login page, you control their speed, and you decide how long each session lasts.
This guide is the most complete MikroTik hotspot setup walkthrough you will find. Every step is tested on real hardware. No fluff.
Applies to: MikroTik hAP ac², hAP lite, RB450Gx4, RB3011, CCR series, CHR — running RouterOS 6.49+ or 7.x.
What You Need Before You Start
- ✅ Any MikroTik router (hAP ac², RB450Gx4, CCR, RB3011, etc.)
- ✅ Winbox installed on your Windows PC (or use WebFig in browser)
- ✅ Internet working on your WAN port (ether1)
- ✅ A LAN interface ready for hotspot clients (ether2, bridge, or wlan1)
- ✅ RouterOS 6.49 or newer (RouterOS 7.x fully supported)
MikroTik Hotspot vs Simple Queue — Which Do You Need?
| Feature | Hotspot | Simple Queue Only |
|---|---|---|
| Login page for clients | ✅ Yes | ❌ No |
| Per-user bandwidth limit | ✅ Yes (via profile) | ✅ Yes (per IP) |
| Session time control | ✅ Yes | ❌ No |
| Data usage limit | ✅ Yes | ❌ No |
| User account management | ✅ Yes | ❌ No |
| MAC address bypass | ✅ Yes | ❌ No |
| Best for | Café, hotel, public WiFi | Home, office LAN |
If you need login control → use Hotspot. For a simple home or office bandwidth limiter, Simple Queue is enough.
MikroTik Hotspot Setup at a Glance
| # | Step | Where in Winbox | Time |
|---|---|---|---|
| 1 | Connect via Winbox | Winbox launcher | 1 min |
| 2 | Assign LAN IP address | IP → Addresses | 1 min |
| 3 | Run Hotspot Setup Wizard | IP → Hotspot → Hotspot Setup | 5 min |
| 4 | Create user profiles | IP → Hotspot → User Profiles | 3 min |
| 5 | Add hotspot users | IP → Hotspot → Users | 2 min |
| 6 | Test login page | Browser on client device | 1 min |
| 7 | Customize login page | Files → hotspot folder | Optional |
Step-by-Step MikroTik Hotspot Setup Guide
Step 1: Connect to Your MikroTik Router via Winbox
- Open Winbox on your PC.
- Click the Neighbors tab. Your MikroTik router will appear in the list.
- Click the MAC address (not the IP) to connect — this works even if IP is not configured yet.
- Login credentials:
- Username:
admin - Password: blank (press Enter) — unless you already set one
- Username:
- Click Connect.
[Screenshot: Winbox Neighbors tab showing MikroTik router with MAC address]
Alt text: Winbox neighbor discovery showing MikroTik router MAC address for login
Step 2: Assign a LAN IP Address to Your Interface
Your hotspot clients need a local IP range. Let’s assign one.
- Go to IP → Addresses.
- Click + (Add).
- Fill in:
- Address:
192.168.88.1/24 - Interface:
ether2(or your LAN bridge name)
- Address:
- Click OK.
Or run this terminal command:
/ip address add address=192.168.88.1/24 interface=ether2[Screenshot: IP Addresses window — 192.168.88.1/24 added on ether2, status R (running)]
Alt text: MikroTik IP Addresses window showing 192.168.88.1/24 on ether2 interface
bridge1, then add all your LAN ports and wlan1 as ports under Bridge → Ports. Assign the IP address to bridge1 instead of ether2.Step 3: Run the MikroTik Hotspot Setup Wizard
The setup wizard handles the complex configuration automatically — DHCP, DNS redirect, firewall rules, and more.
- Go to IP → Hotspot.
- Click the Hotspot Setup button at the top.
- A wizard window opens. Follow each screen:
Complete Wizard Walkthrough:
| Wizard Screen | What to Enter | Notes |
|---|---|---|
| Hotspot Interface | ether2 or bridge1 | Select the LAN/hotspot interface |
| Local Address of Network | 192.168.88.1/24 | Auto-filled from Step 2 |
| Masquerade Network | ✅ Leave checked | Required for internet access |
| Address Pool of Network | 192.168.88.2-192.168.88.254 | 253 client IPs available |
| SSL Certificate | none | Skip for basic setup |
| SMTP Server | Leave blank | Only needed for email login |
| DNS Servers | 8.8.8.8, 8.8.4.4 | Google DNS — fast and reliable |
| DNS Name | wifi.cafe (optional) | Custom URL for your login page |
| Name of Local Hotspot User | admin | First default test user |
- Click Next on each screen.
- Click OK on the final confirmation screen.
✅ Your hotspot is now active. MikroTik has automatically created a DHCP server, DNS redirect, and firewall rules for the hotspot to work.
[Screenshot: Hotspot Setup Wizard — interface selection screen with ether2 selected]
Alt text: MikroTik Hotspot Setup Wizard showing LAN interface selection in Winbox
/ip firewall nat add chain=srcnat out-interface=ether1 action=masqueradeStep 4: Create User Profiles (Bandwidth & Session Limits)
User profiles are the heart of the hotspot. They define how fast each user can browse and how long their session lasts.
- Go to IP → Hotspot → User Profiles tab.
- Click + to add a new profile.
- Configure the fields:
- Name: Give it a clear name, e.g.,
free,basic,premium - Rate Limit (rx/tx): download/upload in Mbps — e.g.,
3M/3M - Session Timeout: e.g.,
2h= 2 hours,1d= 1 day,00:00:00= unlimited - Idle Timeout: e.g.,
10m— kicks user if idle for 10 minutes - Shared Users:
1— prevents the same account being shared on multiple devices
- Name: Give it a clear name, e.g.,
- Click OK.
Recommended Profiles for Cafés and Hotels:
| Profile Name | Rate Limit | Session Timeout | Idle Timeout | Shared Users | Best For |
|---|---|---|---|---|---|
free | 1M/512k | 30m | 5m | 1 | Free trial / lobby preview |
basic | 3M/3M | 2h | 15m | 1 | Regular café customers |
premium | 10M/10M | 24h | 1h | 2 | Hotel room guests |
vip | 20M/20M | 7d | 2h | 3 | Long-stay guests / VIP |
staff | 50M/50M | 00:00:00 | 00:00:00 | 1 | Staff / business owner |
Terminal commands for quick setup:
/ip hotspot user profile
add name=free rate-limit=1M/512k session-timeout=30m idle-timeout=5m shared-users=1
add name=basic rate-limit=3M/3M session-timeout=2h idle-timeout=15m shared-users=1
add name=premium rate-limit=10M/10M session-timeout=24h idle-timeout=1h shared-users=2
add name=staff rate-limit=50M/50M session-timeout=0s idle-timeout=0s shared-users=1[Screenshot: IP → Hotspot → User Profiles tab showing basic and premium profiles with rate limit fields]
Alt text: MikroTik Winbox User Profiles window showing rate limit and session timeout settings
Step 5: Add Hotspot Users
- Go to IP → Hotspot → Users tab.
- Click + to add a user.
- Fill in:
- Name: username, e.g.,
guest1,room101,table5 - Password: e.g.,
cafe2026 - Profile: choose from your profiles —
basic,premium, etc. - Limit Uptime: (optional) e.g.,
5htotal usage per account - Limit Bytes Total: (optional) data cap in bytes, e.g.,
1073741824= 1 GB
- Name: username, e.g.,
- Click OK.
/ip hotspot user
add name=guest1 password=cafe2026 profile=basic
add name=room101 password=hotel@101 profile=premium
add name=staff password=myadmin99 profile=staffroom101, room102, etc. Set a 24h session timeout matching checkout time. Use a scheduler script (see Advanced section) to auto-reset all room accounts daily at midnight.[Screenshot: IP → Hotspot → Users tab showing guest1 and room101 with profile assigned]
Alt text: MikroTik hotspot users list in Winbox showing usernames, profiles, and uptime
Step 6: Test the Hotspot Login Page
- Connect a phone or laptop to your hotspot WiFi (or plug into the LAN port).
- Open a browser and visit http://neverssl.com — this forces an HTTP request.
- You should be automatically redirected to the MikroTik hotspot login page.
- Enter the username and password you created in Step 5.
- Click Log In.
- You now have internet access. ✅
[Screenshot: MikroTik default hotspot login page on mobile Chrome browser]
Alt text: MikroTik hotspot login page showing username and password fields on mobile
Step 7: Customize the Hotspot Login Page (Captive Portal) — Optional
Replace the plain MikroTik login page with your own branded design — café name, logo, custom colors.
- In Winbox, go to Files.
- You will see a folder called
hotspot. Click on it. - Right-click
login.html→ Download. - Open the file in VS Code, Notepad++, or any HTML editor.
- Customize the HTML: add your logo, brand colors, and business name.
- Keep these required variables exactly as they are:
$(username)— login username input field$(password)— password input field$(error)— error message display area$(chap-id)and$(chap-challenge)— for CHAP authentication
- Save the file and drag it back into the
hotspotfolder in Winbox Files. - Test on a client device — your custom page should appear immediately.
alogin.html (shown after successful login), logout.html, and status.html for a fully branded experience throughout the session.Advanced Hotspot Features
Walled Garden — Allow Sites Without Login
Walled Garden lets specific websites work before the user logs in. Use this for your business website, a payment page, or a menu/QR code page.
- Go to IP → Hotspot → Walled Garden tab.
- Click +.
- Enter the domain in Dst. Host, e.g.,
menu.yourcafe.com.np. - Click OK.
/ip hotspot walled-garden
add dst-host=menu.yourcafe.com.np
add dst-host=*.yourhotel.com.npMAC Address Bypass — Skip Login for Trusted Devices
Let your POS system, CCTV, or staff laptop connect without entering credentials:
/ip hotspot user add name=pos-system mac-address=AA:BB:CC:DD:EE:FF profile=staff password=""The device connects automatically — no login page shown.
Auto Reset Hotspot Users Daily (Scheduler)
Ideal for hotels — automatically remove all guest accounts at midnight and start fresh:
/system scheduler add \
name="daily-hotspot-reset" \
interval=1d \
start-time=00:00:00 \
on-event="/ip hotspot user remove [find where profile!=staff]"staff profile. Adjust the filter (profile!=staff) based on your setup to protect accounts you want to keep.Voucher System with User Manager
For paid WiFi (like printing vouchers for café customers), MikroTik’s User Manager package adds a full voucher generation and management system. You can print codes on paper slips and hand them to customers.
User Manager requires the user-manager RouterOS package. Install it via System → Packages → Check for Updates.
Full guide: [Internal Link] MikroTik User Manager Setup Guide
Enable HTTPS on Hotspot Login Page
Modern browsers block HTTP pages by default. Enable HTTPS for the login page:
- Go to System → Certificates.
- Click + → Generate a self-signed certificate for your hotspot domain.
- Go to IP → Hotspot → Server Profiles.
- Open your hotspot server profile and set SSL Certificate to the generated cert.
/certificate add name=hotspot-cert common-name=wifi.cafe days-valid=3650 key-size=2048
/certificate sign hotspot-cert
/ip hotspot profile set [find] ssl-certificate=hotspot-cert login-by=http-chap,httpsMikroTik Hotspot Troubleshooting
These are the most common problems and their exact fixes:
| Problem | Root Cause | Fix |
|---|---|---|
| Login page not showing (browser goes to error) | HTTPS sites bypass redirect | Visit http://neverssl.com to force HTTP redirect |
| Logged in but no internet | Missing masquerade NAT rule | Check IP → Firewall → NAT for srcnat masquerade on WAN (ether1). Add if missing. |
| DNS redirect not working | DHCP DNS not set to MikroTik IP | In IP → DHCP Server → Networks, set DNS Server to 192.168.88.1 |
| Users can’t log in (wrong password error) | Incorrect username/password entered | Verify in IP → Hotspot → Users. Check for spaces in username or password. |
| Bandwidth limit not working | Profile not assigned to user | Edit user → confirm Profile field is set (not default). Check profile rate limit. |
| Session keeps dropping every few minutes | Session timeout too short | Edit User Profile → increase Session Timeout value or set to 00:00:00 |
| Two devices using same account simultaneously | Shared Users set to more than 1 | Edit User Profile → set Shared Users = 1 |
| Login page works on Android but not iPhone | iOS Captive Network Assistant quirk | Add captive.apple.com to Walled Garden. Or enable HTTPS on login page. |
| Router CPU high after enabling hotspot | Too many active sessions or rate-limit queue load | Enable connection tracking fastpath: /ip firewall set enabled=no (only if no complex firewall rules) |
| Hotspot missing after router reboot | Config not saved to flash | Run /system backup save and also confirm hotspot server shows in IP → Hotspot → Servers |
7 Common Mistakes When Setting Up MikroTik Hotspot
These are the real mistakes we see most often — not found in official docs:
-
Running hotspot on ether1 (WAN) instead of ether2 (LAN).
Always run hotspot on the LAN-facing interface. Running it on WAN exposes your login page to the internet. -
Forgetting to enable masquerade after setup.
The wizard should add it automatically, but always verify in IP → Firewall → NAT. Without it, logged-in users get no internet. -
Not setting Idle Timeout on user profiles.
Without idle timeout, one customer can occupy a hotspot slot indefinitely while sitting idle. Set it to 10–15 minutes for cafés. -
Setting Shared Users to 0 (unlimited) by accident.
In RouterOS, Shared Users = 0 means unlimited simultaneous logins. Set it to 1 to prevent account sharing. -
Using the same IP range as an existing DHCP server.
If you already have 192.168.88.0/24 in use elsewhere, use a different subnet for hotspot (e.g., 192.168.100.0/24). -
Not testing on both Android and iOS.
iOS handles captive portal detection differently. Always test the login page on an iPhone before going live. -
Skipping HTTPS for the login page.
Modern browsers default to HTTPS. Without an SSL cert on your hotspot, many users (especially on Chrome/Safari) will see certificate errors or simply not get redirected.
MikroTik Hotspot for Nepal — Practical Advice
-
ISP fiber setup (PPPoE): Most Nepal ISPs use PPPoE authentication. Set up PPPoE client on
ether1first → then run hotspot onether2or bridge. See: MikroTik PPPoE Setup Guide. - Load shedding: Connect your MikroTik + ONU to a UPS (even a small 12V/7Ah battery UPS). Hotspot sessions disconnect on power cut and users must re-login.
- Multi-floor hotels: Use a managed switch + multiple WiFi APs (TP-Link EAP, Ubiquiti, or MikroTik cAP) all connected to the same bridge. One hotspot instance on the MikroTik covers all floors and all APs.
-
Free trial for café customers: Create a
freeprofile (1M/512k, 30 minutes). Print the WiFi name on receipts or tables with the shared password. Customers can connect once per visit. - NTA compliance: Nepal’s NTA regulations require ISPs and public WiFi operators to log user sessions. Enable hotspot logging: IP → Hotspot → Active logs all sessions. For longer retention, send logs to a syslog server.
Key Takeaways
- ✅ The Hotspot Setup Wizard (IP → Hotspot → Hotspot Setup) does 90% of the work in under 5 minutes.
- ✅ User Profiles are how you control bandwidth (Rate Limit) and session duration (Session Timeout).
- ✅ Always verify the masquerade NAT rule exists on your WAN interface after setup.
- ✅ Use http://neverssl.com to test hotspot redirect — modern browsers use HTTPS by default.
- ✅ Shared Users = 1 in the profile prevents one account being used on multiple devices.
- ✅ Walled Garden allows your business website to load before login.
- ✅ For iOS devices, add
captive.apple.comto Walled Garden or enable HTTPS on the login page. - ✅ MAC address bypass is the cleanest way to give staff or devices internet without login.
Frequently Asked Questions
What is a MikroTik Hotspot?
A MikroTik Hotspot is a built-in RouterOS feature that creates a captive portal — a mandatory login page that WiFi users must pass through before accessing the internet. It lets you control who connects, limit their bandwidth, set session time limits, and track data usage. It is widely used in cafés, hotels, schools, and public WiFi deployments.
Why is the MikroTik hotspot login page not showing?
The most common reasons: (1) Your browser is trying HTTPS by default — open http://neverssl.com to force an HTTP redirect. (2) DNS is not pointing to the MikroTik IP — in IP → DHCP Server → Networks, set DNS Server to 192.168.88.1. (3) Masquerade NAT rule is missing — check IP → Firewall → NAT for srcnat masquerade on ether1.
How do I limit internet speed per user in MikroTik Hotspot?
Create a User Profile in IP → Hotspot → User Profiles and set the Rate Limit field. Format: download/upload. Example: 5M/5M = 5 Mbps each way. Assign this profile to users in the Users tab. Each logged-in user gets their own bandwidth slice.
Is MikroTik Hotspot completely free?
Yes. The core hotspot feature in RouterOS requires no additional license. You can create unlimited user profiles and users at no cost. The optional User Manager package (for advanced voucher printing and radius management) requires a RouterOS license upgrade on certain hardware.
How many users can MikroTik Hotspot handle at once?
It depends on hardware. A hAP ac² handles 50–100 users comfortably. A CCR2004 handles 500+ simultaneous users. In practice, your ISP bandwidth is the real bottleneck. Use Queue Trees or PCQ queues to ensure fair sharing across all users.
Can MikroTik Hotspot work with an external WiFi access point?
Yes. Add your external AP’s uplink cable into the same bridge as your hotspot LAN interface. All wireless clients from the AP will be directed through the MikroTik hotspot login page. This works with any brand of AP — TP-Link, Ubiquiti, D-Link, or another MikroTik.
How do I create a custom branded login page for my café?
In Winbox, go to Files → hotspot folder → download login.html. Edit it with any HTML editor — add your logo, brand colors, café name. Keep the RouterOS variables ($(username), $(password), $(error)) intact. Upload the edited file back to the hotspot folder. Your custom page goes live immediately.
What is Walled Garden in MikroTik Hotspot?
Walled Garden is a feature that lets you whitelist specific websites so they are accessible without login. For example, you can allow your hotel’s menu page or a payment portal to load before the guest authenticates. Configure it in IP → Hotspot → Walled Garden. Add the domain in the Dst. Host field.
Related MikroTik Guides on Madankc.com.np
- 📌 MikroTik Guides — Full Hub Page
- 📌 MikroTik PPPoE Setup for Nepal ISP (Winbox Guide)
- 📌 MikroTik Simple Queue — Bandwidth Limit Per User
- 📌 MikroTik Firewall Rules for Beginners
- 📌 192.168.88.1 — MikroTik Default Login Guide
- 📌 ONU LOS Blinking Fix — Nepal ISP Fiber Guide
- 📌 Fiber Internet Not Working in Nepal — Full Fix Guide
External reference: Official MikroTik Hotspot Documentation — help.mikrotik.com
Did This Guide Help You?
Tell us in the comments: What MikroTik model are you using, and what’s your hotspot use case — café, hotel, school, or ISP? If you got stuck at any step, drop the error or screenshot below and we’ll help you fix it. 👇
Found this useful? Share it with a fellow network engineer in Nepal 🙏
