To set up a custom MikroTik hotspot login page, you must replace the default login.html file in the router's file system with your custom template. These templates use specific RouterOS variables to handle authentication and user data. 1. Getting or Creating a Template You can either design a custom page from scratch or download pre-made templates: Pre-designed Themes : Sites like Ilhamuddin Sirait's GitHub offer free responsive themes including "Terminal Style," "Office," and "World Cup". Other sources include Mikmon GitHub or Mikrotikthemes.com. Essential Files : A standard hotspot folder contains login.html (the primary page), alogin.html (shown after successful login), and status.html (user status page). Core Variables : Templates must include variables like $(link-login-only) for the form action and $(if chap-id) for handling MD5 hashing. 2. Uploading the Template to MikroTik Once you have your template folder ready: Open Winbox : Connect to your router and open the Files menu. Upload Files : Drag and drop your custom hotspot folder from your PC into the Files list. Reset/Cleanup : It is often recommended to delete the old hotspot folder first or rename your new folder to avoid confusion. 3. Activating the Custom Page After uploading, you must tell the router to use the new directory: Hotspot customisation - RouterOS - MikroTik Documentation
This template goes beyond basic authentication; it creates a branded, functional, and intelligent gateway.
Product Feature: SmartLink Hotspot Portal v2.0 Compatible with: MikroTik RouterOS (v6+ & v7+) Branding Focus: "The Link" (Connecting users, devices, and loyalty) 1. Dynamic Multi-Tier Authentication Layer Instead of a single password field, the template offers three distinct login paths, all linking back to the MikroTik Hotspot's built-in user manager or RADIUS server.
High-Speed Voucher Login: A large, clean input field for prepaid codes (alphanumeric, case-insensitive). Auto-strips spaces and dashes. Feature: "One-Click Redemption" – scans a QR code from a physical receipt to auto-fill and login. Social Login Link (Walled Garden): Buttons for Facebook, Google, and Telegram. MikroTik specific: Uses a PHP or API script to create temporary user accounts in the MikroTik user database upon successful OAuth, then redirects to the original destination. Room/Apartment Login (MAC Bypass Link): For hotels or rentals. A simple field for "Room Number + Last Name." The template checks against a local CSV or RADIUS attribute. Feature: Automatically links the device's MAC address for 30 days (no re-login). hotspot login page template mikrotik link
2. "The Link" Branding & Customization Engine
Dynamic Hero Image Rotator: The background image changes based on time of day (morning coffee, afternoon work, evening chill). All images are stored locally on the MikroTik's internal storage or a USB drive. Branding Link Bar: At the top, a sleek bar displaying partner logos (e.g., "Free WiFi by The Grand Hotel | Bandwidth by FiberLink "). Each logo can be clicked to open a walled-garden link to the partner's website. Live Clock & Weather Link: Displays local time and temperature using a free API. The "weather widget" also shows a simple icon (sunny/rainy). Clicking it links to the local weather radar (walled garden).
3. User Status & Account Link (Post-Login Popup) After login, the user does not leave the page. Instead, a small overlay appears that can be minimized. This overlay provides: To set up a custom MikroTik hotspot login
Data Usage Link: A live progress bar showing how much of their session/quota is used (fetched via MikroTik's REST API or SNMP). Speed Test Link: A lightweight HTML5 speed test that does not break the hotspot's URPF rules. Results are sent anonymously to the admin. Logout Link: A giant red "Disconnect" button. Device Manager Link: Shows all devices currently logged in under that same voucher/account. Allows the user to kick an old device (e.g., "Forgot phone at home? Disconnect it remotely").
4. Marketing & Data Capture Link This feature turns the login page into a lead generation tool.
Optional Pre-Login Survey Link: A single mandatory question before the login button appears (e.g., "How did you hear about us?"). Answers are saved as a comment in the MikroTik user log. Newsletter Consent Checkbox: "Tick here to receive 10% off your next coffee" – links to a Mailchimp API endpoint (walled garden) while the user stays on the login page. Referral Link Generation: After login, the user gets a unique URL (e.g., hotspot.link/refer/ABC123 ). If a friend logs in using that link, the original user gets +30 minutes free. Getting or Creating a Template You can either
5. Advanced Network Link Management
Bandwidth Selector Slider: For tiered hotspots. The user slides between "Free (1Mbps)" and "Premium (10Mbps – $2)". The template communicates with MikroTik to change the user's rate-limit profile before login. Parental Control Link: A simple toggle: "Safe Mode: Block adult content." This adds the user's IP to an address list that routes through a filtered DNS (e.g., OpenDNS FamilyShield). Language Link Selector: Dropdown for English, Spanish, French, German. The entire template switches instantly without reloading the main page.
