Connect Your Own UniFi Controller to BetterSTR

If you already own a Ubiquiti UniFi Controller, UniFi OS Console or Dream Machine Pro (DMP), you can connect it to BetterSTR so we can run your guest captive portal and Wifi marketing on your existing hardware. This guide walks you through creating a dedicated local admin account on your UniFi console and then linking it to BetterSTR.

Part 1 — Create a BetterSTR admin account in UniFi

1. Open your UniFi Controller or Dream Machine Pro (DMP).
2. Click the People icon in the left menu (near the bottom) and you should see your existing user accounts.
3. Click Add New Person. Do not enter an email address — just set the name to BetterSTR Admin and click Save.

4. Under Roles, select Full Access and click Save.
5. Toggle on Local Account Only, then give it a username of betterstr and a random password. Make a note of this password — you’ll need it in the next step.
6. Click Save.

Part 2 — Allow remote access to your controller

For BetterSTR to run your captive portal, your UniFi console must be reachable from the Internet. If you don’t yet have remote access set up, you’ll need to allow remote connections. The important setting is Allow WAN Access (Remote Access via IP).

1. Go to Settings → Control Plane (or Console Settings, depending on your UniFi OS version).
2. Look for a setting similar to one of these — the exact wording varies by version:
   • Enable Direct Remote Connection
   • Allow Management from WAN
   • Remote Management
   • Restrict Management Access
3. Enable WAN / remote access so your console can be reached over the Internet.

Part 3 — Connect your controller to BetterSTR

1. Log in to BetterSTR and click Wifi Devices in the left menu, then Custom-Owned Unifi.
2. Click Add New Controller.
3. Follow the instructions on the form:
   • Select the property this controller belongs to.
   • Give the controller a name.
   • Enter the external URL — your public Internet IP address.
   • Enter the username betterstr and the password you chose in Part 1.
4. Click Connect and Test. Your Wifi controller should now show as connected.