Connect a UniFi controller
Add your UniFi server with a local admin login, open its port to Stampede, map each site to its venue, and fix Login failed or Port blocked.
3 min read · Updated
In short: create a local admin on UniFi, add your server once for your organisation, then map each UniFi site to the venue it serves.
Before you start
Your IT provider can do this part.
- A local admin: in UniFi, go to OS Settings › Admins and add a dedicated local admin, such as StampedeSupport, with a password and access to this venue's site. A Ubiquiti cloud or SSO login cannot be used, so an account that only signs in by email with a code will not work.
- An open port: Stampede reaches your controller over the internet on 8443 for classic controllers, or 443 for UniFi OS. If the controller is behind the venue firewall, add a port forward or allow Stampede through.
Add your server
- Go to Marketplace & API › Apps › UniFi.
- Click Add first server, or Add server if you already have one.
- Enter the Server address, Username and Password, then click Add server.
Map sites to venues
- On your server's card, under Venue mapping, click Map venues.
- Pick the venue each UniFi site serves. You see Assigned when it saves.
- 01Add server
- 02Click Map venues
- 03Pick each venue
- 04Assigned
Two venues on the same UniFi site? With the venue chosen, go to Wi-Fi › Hardware › Overview, turn on Two venues share this site, pick This venue's SSID, then click Link site and provision. Do the same for the other venue.
Check it worked
The server shows Connected, with Port Open and Login Verified. Join the venue's guest Wi-Fi on your phone: the login page should open.
If it does not work
Port shows Blocked
You see UniFi server port is blocked. Click Copy IPs and send the addresses to your IT provider to allow through the firewall, then click Refresh.
Login shows Failed
You see Authentication failed. The password changed or the admin was removed. Click Fix, update Username and Password, click Update server, then click Refresh.
While any server has a problem, the page says Some servers need attention. Fix the card marked Needs attention.
A venue shows an alert
At the top of the UniFi page:
- Controller unreachable: Stampede cannot reach or sign in to the controller. Check the port and login above.
- Controller out of sync: the controller no longer has this venue's guest setup. Check the server address is still right.
- No access points: no access points are registered for the venue on the controller.
- Update queued: Stampede is re-applying the settings. It normally clears within a few minutes.
No sites to pick
The admin cannot see that site. Give it access to the site in UniFi.
Email support at agent@stampede.ai with:
- Your UniFi server address and port.
- The site and venue that are not working.
- Contact details for your IT provider.
Good to know
- Planning a controller upgrade or move? Tell support first, so guests are not left without a login page.
- After changing sites on the controller, check every venue mapped to it. Manage on a server lets you change its login at any time.
- For other hardware, see connect your own Wi-Fi hardware.
- FOH and IT cannot see Marketplace & API.
Related articles
A deposit did not come off the Square bill
The deposit only moves onto the Square bill when the booking is marked Seated. How to push a missing one, and what to do after a table move.Products, prices or customers are not syncing from Square
A Square change is missing in Stampede? Run Sync from Square on Products, then check the item is stocked at that venue in Square.Is it a Square question or a Stampede one?
Till layout, cashing up, Z reports and handheld item tools live in Square. Bookings, deposits, table matches and ordering menus live in Stampede.Square bill missing from a booking, or on the wrong one
Square bills find their booking through the table. Fix Table Mappings, move a bill to the right booking, or unlock its tables.