Skip to content

Winbox

Prerequisites

This guide assumes Winbox 4.0 is already downloaded. If not, download it from the manufacturer’s website.

The device must be connected as shown in the connection guide.

Compatibility

Social WiFi is compatible with the following configurations:

RouterOS versions:

  • 6.x
  • 7.5 and newer, tested up to 7.19.4 (hotspot doesn’t work on RouterOS 7 below version 7.5)

Accessing the router

To access the router:

  1. Start Winbox.
  2. At the top, set “Connect To” to the router’s MAC address found in the “Neighbors” tab.
  3. The router should appear on the list; double-click it.
  4. Click the blue “Connect” button.

2025-09-10_15-34.png

2025-09-15_12-28.png

Press CTRL+C to skip changing the password. Leave the terminal window open.

2025-09-10_12-39.png

Social WiFi configuration

Hotspot files download

Copy and paste the following script into the terminal:

{
:local downloadEndpoint "https://login.socialwifi.com/installation/mikrotik/download";
:local fileNames {"login.html"; "rlogin.html"; "alogin.html"; "flogin.html"; "md5.js"}
:local destinationDirectory "";
:if ([:len [/file find name="flash" type="disk"]] > 0) do={
:set destinationDirectory "/flash/";
}
:local ether1Mac ([/interface get [find name="ether1"]]->"mac-address");
:foreach fileName in=$fileNames do={
:put "Downloading file: $downloadEndpoint/$fileName\?mac=$ether1Mac"
/tool fetch url="$downloadEndpoint/$fileName\?mac=$ether1Mac" dst-path="$destinationDirectory$fileName"
}
}

The files will download automatically after running the script.

2025-09-10_12-40.png

Walled Garden configuration

Copy and paste the following commands into the terminal. All commands can be pasted at once.

## Social WiFi
/ip hotspot walled-garden
add comment="socialwifi: Allow captive portal main service." dst-host=*.socialwifi.com
add comment="socialwifi: Allow captive portal main service." dst-host=sw-login.com
## YouTube widget
/ip hotspot walled-garden
add comment="socialwifi: Allow YouTube widget." dst-host=*.youtube.com
add comment="socialwifi: Allow YouTube widget. It's a workaround for Mikrotik walled garden bug with CNAME in DNS response. Required to allow www.youtube.com." dst-host=youtube-ui.l.google.com
add comment="socialwifi: Allow YouTube widget. It's a workaround for Mikrotik walled garden bug with CNAME in DNS response. Required to allow img.youtube.com." dst-host=ytimg.l.google.com
add comment="socialwifi: Allow YouTube widget." dst-host=*.ytimg.com
add comment="socialwifi: Allow YouTube widget." dst-host=*.googlevideo.com
add comment="socialwifi: Allow YouTube widget." dst-host=yt3.ggpht.com
add comment="socialwifi: Allow YouTube widget. It's a workaround for Mikrotik walled garden bug with CNAME in DNS response. Required to allow yt3.ggpht.com." dst-host=*.l.googleusercontent.com
## Facebook remarketing pixel
/ip hotspot walled-garden
add comment="socialwifi: Allow Facebook remarketing pixel." dst-host=*.facebook.com
add comment="socialwifi: Allow Facebook remarketing pixel." dst-host=connect.facebook.net
add comment="socialwifi: Allow Facebook remarketing pixel. It's a workaround for Mikrotik walled garden bug with CNAME in DNS response. Required to allow connect.facebook.net." dst-host=*.fbcdn.net
## Google remarketing tag
/ip hotspot walled-garden
add comment="socialwifi: Allow Google remarketing tag." dst-host=www.googletagmanager.com
add comment="socialwifi: Allow Google remarketing tag. It's a workaround for Mikrotik walled garden bug with CNAME in DNS response. Required to allow www.googletagmanager.com." dst-host=www-googletagmanager.l.google.com
add comment="socialwifi: Allow Google remarketing tag." dst-host=www.googleadservices.com
add comment="socialwifi: Allow Google remarketing tag. It's a workaround for Mikrotik walled garden bug with CNAME in DNS response. Required to allow www.googleadservices.com." dst-host=pagead*.l.doubleclick.net
add comment="socialwifi: Allow Google remarketing tag." dst-host=www.google.*
## Facebook
/ip hotspot walled-garden
add comment="socialwifi: Allow login with Facebook." dst-host=facebook.com
add comment="socialwifi: Allow login with Facebook." dst-host=*.facebook.com
add comment="socialwifi: Allow login with Facebook." dst-host=*.fbcdn.net
## LinkedIn
/ip hotspot walled-garden
add comment="socialwifi: Allow login with LinkedIn." dst-host=linkedin.com
add comment="socialwifi: Allow login with LinkedIn." dst-host=*.linkedin.com
add comment="socialwifi: Allow login with LinkedIn. It's a workaround for Mikrotik walled garden bug with CNAME in DNS response. Required to allow www.linkedin.com." dst-host=*.l-msedge.net
add comment="socialwifi: Allow login with LinkedIn. It's a workaround for Mikrotik walled garden bug with CNAME in DNS response. Required to allow www.linkedin.com." dst-host=*.dc-msedge.net
add comment="socialwifi: Allow login with LinkedIn." dst-host=*.licdn.com
add comment="socialwifi: Allow login with LinkedIn. It's a workaround for Mikrotik walled garden bug with CNAME in DNS response. Required to allow static-exp1.licdn.com." dst-host=*.epsiloncdn.net
add comment="socialwifi: Allow login with LinkedIn. It's a workaround for Mikrotik walled garden bug with CNAME in DNS response. Required to allow static-exp1.licdn.com." dst-host=*.akamai.net
add comment="socialwifi: Allow login with LinkedIn. It's a workaround for Mikrotik walled garden bug with CNAME in DNS response. Required to allow www.linkedin.com." dst-host=www.linkedin.com.cdn.cloudflare.net
## Twitter
/ip hotspot walled-garden
add comment="socialwifi: Allow login with Twitter." dst-host=x.com
add comment="socialwifi: Allow login with Twitter." dst-host=api.x.com
add comment="socialwifi: Allow login with Twitter. It's a workaround for Mikrotik walled garden bug with CNAME in DNS response. Required to allow api.x.com." dst-host=api.x.com.cdn.cloudflare.net
add comment="socialwifi: Allow login with Twitter. It's a workaround for Mikrotik walled garden bug with CNAME in DNS response. Required to allow api.x.com." dst-host=tpop-api.x.com
add comment="socialwifi: Allow login with Twitter." dst-host=twitter.com
add comment="socialwifi: Allow login with Twitter." dst-host=api.twitter.com
add comment="socialwifi: Allow login with Twitter. It's a workaround for Mikrotik walled garden bug with CNAME in DNS response. Required to allow api.api.com." dst-host=api.twitter.com.cdn.cloudflare.net
add comment="socialwifi: Allow login with Twitter. It's a workaround for Mikrotik walled garden bug with CNAME in DNS response. Required to allow api.twitter.com." dst-host=*.twitter.com
add comment="socialwifi: Allow login with Twitter." dst-host=*.twimg.com
add comment="socialwifi: Allow login with Twitter. It's a workaround for Mikrotik walled garden bug with CNAME in DNS response. Required to allow pbs.twimg.com." dst-host=pbs.twimg.com.cdn.cloudflare.net
add comment="socialwifi: Allow login with Twitter. It's a workaround for Mikrotik walled garden bug with CNAME in DNS response. Required to allow abs.twimg.com." dst-host=twimg.twitter.map.fastly.net
/

2025-09-10_12-56.png

Add new bridge

Navigate to Interfaces from the left-hand menu. In the Interface tab, click New and select Bridge.

2025-09-10_12-25.png

Set the Name field to sw and click OK.

2025-09-10_12-27.png

Add new guest network

Navigate to IP -> Addresses and click New.

2025-09-10_12-28.png

Configure as follows:

Address10.8.0.1/16
Network10.8.0.0
Interfacesw

2025-09-10_12-29.png

Click OK.

Next, navigate to IP -> Pool and click New.

2025-09-10_12-32.png

Configure as follows:

Namedhcp_pool_sw
Addresses10.8.0.2-10.8.255.254

2025-09-10_12-32_1.png

Click OK.

Navigate to IP -> DHCP Server. In the DHCP tab, click New.

2025-09-10_12-34.png

Configure as follows:

Namedhcp_sw
Interfacesw
Lease Time2d 00:00:00
Address Pooldhcp_pool_sw

2025-09-10_12-36.png

Click OK.

Switch to the Networks tab and click New.

2025-09-10_12-37.png

Configure as follows:

Address10.8.0.0/16
Gateway10.8.0.1

2025-09-10_12-38.png

Click OK.

RADIUS configuration

Navigate to the RADIUS section and click New.

2025-09-10_12-44.png

Configure as follows:

Servicehotspot
Address35.205.62.147
SecretThe RADIUS Secret is available in the Access Points tab of the Social WiFi Panel.
Authentication Port31812
Accounting Port31813
Timeout1000
Accounting BackupUnchecked
Require Message Authyes for request resp (This field is only available in RouterOS 7.13 and newer.)

2025-09-10_12-45.png

Click OK.

Hotspot configuration

Navigate to IP -> Hotspot. In the Servers tab, click New.

2025-09-18_12-47.png

Configure as follows:

Namesocialwifi
Interfacesw
Address Poolnone
Profiledefault
Idle Timeout00:05:00

2025-09-10_12-52.png

Click OK.

Switch to the Server Profiles tab. Double-click the default profile.

2025-09-18_12-56.png

Configure as follows:

  • In the General tab:

    DNS Namelogging.sw.com
    HTML DirectoryChange the name to . (a period). If the Files section contains a “flash” folder, set this field to flash/.

    2025-09-10_12-49.png

  • In the Login tab:

    Set Login By to HTTP PAP (uncheck all other options).

    2025-09-10_12-50.png

  • In the RADIUS tab:

    Use RADIUSyes
    Interim Update00:10:00

    2025-09-10_12-50_1.png

    Click OK.

Switch to User Profiles. Double-click the default profile.

2025-09-10_12-54.png

Set the Keepalive Timeout value to 2d 00:00:00.

2025-09-10_12-55.png

Click OK.

Interfaces configuration

Navigate to the Bridge section and open the Ports tab.

Double-click the interface to be used for Social WiFi.

2025-09-10_16-45.png

Change the Bridge value to sw.

2025-09-10_16-45_1.png

Click OK.

For VLAN configurations, refer to the VLANs and Additional APs guide after completing these steps.

Social WiFi dashboard

Add the router MAC address to the panel

Navigate to Interfaces, double-click ether1, and find the MAC Address.

2025-09-10_14-27.png

Copy the value from the MAC Address field.

Log in to the Social WiFi Dashboard, navigate to the Access Points section, and click +Add.

2024-08-21_16-36.png

Paste the copied MAC address into the form. Naming the device is optional. Click Create.

2025-09-15_16-02_1.png

Test the solution

Connect to the WiFi network. A login page should appear. Complete the login process to gain internet access. Connections and authorizations will appear in the Statistics section of the Social WiFi Panel.