MikroTik Hotspot Setup Step by Step (Café & Hotel WiFi 2026

Contents

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.

⚡ What You Will Learn in This Guide:
  • 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)
🇳🇵 Nepal Tip: Most ISPs in Nepal — WorldLink, Subisu, Vianet, CG Net, Dishhome Fiber — deliver fiber via ONU/ONT. Connect your ONU’s LAN port to MikroTik ether1. Use ether2 (or a bridge including your WiFi) for hotspot clients. If your ISP uses PPPoE, set up PPPoE on ether1 first, then run the hotspot on ether2.

MikroTik Hotspot vs Simple Queue — Which Do You Need?

FeatureHotspotSimple 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 forCafé, hotel, public WiFiHome, 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

#StepWhere in WinboxTime
1Connect via WinboxWinbox launcher1 min
2Assign LAN IP addressIP → Addresses1 min
3Run Hotspot Setup WizardIP → Hotspot → Hotspot Setup5 min
4Create user profilesIP → Hotspot → User Profiles3 min
5Add hotspot usersIP → Hotspot → Users2 min
6Test login pageBrowser on client device1 min
7Customize login pageFiles → hotspot folderOptional

Step-by-Step MikroTik Hotspot Setup Guide

Step 1: Connect to Your MikroTik Router via Winbox

  1. Open Winbox on your PC.
  2. Click the Neighbors tab. Your MikroTik router will appear in the list.
  3. Click the MAC address (not the IP) to connect — this works even if IP is not configured yet.
  4. Login credentials:
    • Username: admin
    • Password: blank (press Enter) — unless you already set one
  5. Click Connect.
💡 Tip: If Winbox doesn’t detect the router, make sure your PC is connected to the MikroTik LAN port with a cable. Disable any VPN or firewall on your PC temporarily.

[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.

  1. Go to IP → Addresses.
  2. Click + (Add).
  3. Fill in:
    • Address: 192.168.88.1/24
    • Interface: ether2 (or your LAN bridge name)
  4. 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

ℹ️ Using a Bridge? If your hotspot should cover both wired (ether2, ether3) and WiFi (wlan1) clients, first create a bridge: Bridge → Bridge → Add (+), name it 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.

  1. Go to IP → Hotspot.
  2. Click the Hotspot Setup button at the top.
  3. A wizard window opens. Follow each screen:

Complete Wizard Walkthrough:

Wizard ScreenWhat to EnterNotes
Hotspot Interfaceether2 or bridge1Select the LAN/hotspot interface
Local Address of Network192.168.88.1/24Auto-filled from Step 2
Masquerade Network✅ Leave checkedRequired for internet access
Address Pool of Network192.168.88.2-192.168.88.254253 client IPs available
SSL CertificatenoneSkip for basic setup
SMTP ServerLeave blankOnly needed for email login
DNS Servers8.8.8.8, 8.8.4.4Google DNS — fast and reliable
DNS Namewifi.cafe (optional)Custom URL for your login page
Name of Local Hotspot UseradminFirst default test user
  1. Click Next on each screen.
  2. 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

⚠️ Important: After the wizard runs, go to IP → Firewall → NAT and verify there is a srcnat rule with masquerade on your WAN interface (ether1). If it is missing, clients will log in but have no internet. Add it manually if needed:
/ip firewall nat add chain=srcnat out-interface=ether1 action=masquerade

Step 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.

  1. Go to IP → Hotspot → User Profiles tab.
  2. Click + to add a new profile.
  3. 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
  4. Click OK.

Recommended Profiles for Cafés and Hotels:

Profile NameRate LimitSession TimeoutIdle TimeoutShared UsersBest For
free1M/512k30m5m1Free trial / lobby preview
basic3M/3M2h15m1Regular café customers
premium10M/10M24h1h2Hotel room guests
vip20M/20M7d2h3Long-stay guests / VIP
staff50M/50M00:00:0000:00:001Staff / 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

  1. Go to IP → Hotspot → Users tab.
  2. Click + to add a user.
  3. 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., 5h total usage per account
    • Limit Bytes Total: (optional) data cap in bytes, e.g., 1073741824 = 1 GB
  4. 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=staff
💡 Hotel Tip: Name accounts by room number: room101, 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

  1. Connect a phone or laptop to your hotspot WiFi (or plug into the LAN port).
  2. Open a browser and visit http://neverssl.com — this forces an HTTP request.
  3. You should be automatically redirected to the MikroTik hotspot login page.
  4. Enter the username and password you created in Step 5.
  5. Click Log In.
  6. 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

⚠️ Login page not appearing? See the Troubleshooting section below for all fixes.

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.

  1. In Winbox, go to Files.
  2. You will see a folder called hotspot. Click on it.
  3. Right-click login.htmlDownload.
  4. Open the file in VS Code, Notepad++, or any HTML editor.
  5. Customize the HTML: add your logo, brand colors, and business name.
  6. 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
  7. Save the file and drag it back into the hotspot folder in Winbox Files.
  8. Test on a client device — your custom page should appear immediately.
💡 Pro Tip: You can also edit 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.

  1. Go to IP → Hotspot → Walled Garden tab.
  2. Click +.
  3. Enter the domain in Dst. Host, e.g., menu.yourcafe.com.np.
  4. Click OK.
/ip hotspot walled-garden
add dst-host=menu.yourcafe.com.np
add dst-host=*.yourhotel.com.np

MAC 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]"
⚠️ Warning: This command removes ALL users not on the 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:

  1. Go to System → Certificates.
  2. Click + → Generate a self-signed certificate for your hotspot domain.
  3. Go to IP → Hotspot → Server Profiles.
  4. 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,https

MikroTik Hotspot Troubleshooting

These are the most common problems and their exact fixes:

ProblemRoot CauseFix
Login page not showing (browser goes to error)HTTPS sites bypass redirectVisit http://neverssl.com to force HTTP redirect
Logged in but no internetMissing masquerade NAT ruleCheck IP → Firewall → NAT for srcnat masquerade on WAN (ether1). Add if missing.
DNS redirect not workingDHCP DNS not set to MikroTik IPIn IP → DHCP Server → Networks, set DNS Server to 192.168.88.1
Users can’t log in (wrong password error)Incorrect username/password enteredVerify in IP → Hotspot → Users. Check for spaces in username or password.
Bandwidth limit not workingProfile not assigned to userEdit user → confirm Profile field is set (not default). Check profile rate limit.
Session keeps dropping every few minutesSession timeout too shortEdit User Profile → increase Session Timeout value or set to 00:00:00
Two devices using same account simultaneouslyShared Users set to more than 1Edit User Profile → set Shared Users = 1
Login page works on Android but not iPhoneiOS Captive Network Assistant quirkAdd captive.apple.com to Walled Garden. Or enable HTTPS on login page.
Router CPU high after enabling hotspotToo many active sessions or rate-limit queue loadEnable connection tracking fastpath: /ip firewall set enabled=no (only if no complex firewall rules)
Hotspot missing after router rebootConfig not saved to flashRun /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:

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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).
  6. Not testing on both Android and iOS.
    iOS handles captive portal detection differently. Always test the login page on an iPhone before going live.
  7. 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 ether1 first → then run hotspot on ether2 or 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 free profile (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.com to 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.

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 🙏