Skip to content

Set-up wizard ​

The first time you sign in to my.captifi.io the set-up wizard opens. It asks how guests connect to your WiFi, then shows only the steps that apply to that choice. Most venues finish in five to ten minutes.

You can close the wizard at any point. It saves each step as you complete it, and it reopens where you left off the next time you sign in, on any device.

A progress bar runs across the top of every screen. It starts with Account created already ticked, has a marker for each step of the path you chose, and is filled as far as the step you are on. Beside it you see how much is done or, once you are past half way, how many steps are left. To go back to a step you have finished, click its marker. On a phone the step names are hidden, and the line above the bar names the step you are on.

Every screen of the wizard ends with Need help? Email support@captifi.io. The link opens an email with a subject naming the step you are on, so we can see where you are before we reply. If a partner set up your account, it goes to their support address instead.

Signed up on the website?

Your business details and plan were captured at sign-up, so the wizard does not ask for them again.

If the wizard does ask about your business, the Country and Timezone fields start from your browser. The timezone starts on the one your computer uses when it is in the list, otherwise on Europe/London. The country starts on the one your computer's timezone or your browser's language points to, otherwise on the United Kingdom. A country or timezone you have already saved stays as it is.

Step 1: Choose how guests connect ​

The first screen, How do guests connect to WiFi?, lists every way CaptiFi can run your guest WiFi: the CaptiFi Plug & Play card at the top, the three UniFi cards, then Other WiFi brands. Click one card, then Continue. Nothing is selected for you, and Continue stays greyed out until you choose.

The CaptiFi Plug & Play card shows the device's refundable deposit beside its name, in your own currency (for example £60.00 or $99.00). It is the amount the Delivery and payment step takes, so you know it before you choose. If a partner looks after your billing, no deposit is shown.

The set-up wizard screen How do guests connect to WiFi, with the progress bar above the card showing Account created ticked, the CaptiFi Plug and Play card and its refundable deposit, the three UniFi cards, the Other WiFi brands cards with each brand's logo and name, the Other hardware card under them, and the Need help? Email support@captifi.io link under the card

CardChoose it whenSteps that follow
CaptiFi Plug & PlayYou want a pre-configured access point posted to you. No controller needed. On every plan.Delivery and payment, venue, activate WiFi
UniFi API keyYour UniFi console is reachable from the internet and runs UniFi Network 9.1.105 or newer.Connect via API key, venue, activate WiFi
UniFi Remote TunnelYour console sits behind another router, or you have no public IP (double NAT, CGNAT, 4G or Starlink).Venue, install the tunnel, connect with API key, go live
UniFi username and passwordA self-hosted controller reachable from the internet, signed in with a local admin account.Find your controller, connect UniFi, venue, activate WiFi
TP-Link OmadaAn OC200, OC300, software controller or the paid Cloud-Based Controller.Connect Omada, venue, activate WiFi
Ruckus UnleashedRuckus access points running Unleashed. The wizard shows your portal URL and RADIUS values.Connect Ruckus, venue, activate WiFi
Aruba Instant OnAruba Instant On access points. Guided setup: the wizard generates your portal URL and RADIUS details.Venue, configure your controller, check the connection
Cisco MerakiMeraki MR access points. Guided setup: the wizard shows your splash URL and walled garden list.Venue, configure your controller, check the connection
Cisco Catalyst 9800 / AireOSA Cisco wireless LAN controller. Guided setup: the wizard builds your RADIUS, CoA and redirect ACL config pack.Venue, configure your controller, check the connection
Fortinet FortiAPFortiAP access points managed by a FortiGate. Guided setup: the wizard generates the portal URL, RADIUS shared secret and NAS identifier your IT team enters on the FortiGate.Venue, configure your controller, check the connection
Other hardwareYour WiFi brand has no card of its own, for example MikroTik, DrayTek or Zyxel. Our support team sets it up with you.Your WiFi hardware

On Lite you see the same cards, so you can pick CaptiFi Plug & Play and order the device with its refundable deposit, or pick the card for your controller. See The Lite plan.

For MikroTik, DrayTek and anything else not listed, choose Other hardware, the card under the brand cards, and tell us what you have (see Path: Other hardware). If you are not sure which card to pick, click See how to tell beside Continue (it opens Choosing your hardware), or click start with a CaptiFi device and we set it up with you next to it.

Step 2: Set up your venue ​

Every path except Other hardware asks for the venue next, on the Set up your venue screen. The fields are the same for all of them, with a few extras on some paths (steps 1, 7 and 8 below).

The set-up wizard Set up your venue step for Aruba Instant On, with the progress bar at Step 2 of 4 and the venue name, city, venue type, venue address search and WiFi network name fields

  1. On the UniFi API key and UniFi username and password paths, a Controller site dropdown comes first, listing the sites CaptiFi found on your controller. Pick the site this venue maps to.
  2. Venue name: what the venue is called. Your business name is filled in for you.
  3. City: optional.
  4. Venue type: restaurant, bar or pub, cafe, hotel, retail or other. This sets sensible defaults for your splash page.
  5. Venue address: optional. Choose the Country, type the postcode or street in Postcode or address and click Find address, then pick the address from the list. A UK postcode answer has no street, and in a city no town, so type those in before you continue. Enter the address by hand opens the same boxes empty. A picked town fills an empty City box. The address is saved when you click Continue, and you can add or change it later in My Venues → Edit venue.
  6. WiFi network name (SSID): the network guests tap to join, up to 32 characters. A suggestion based on your venue name is filled in.
  7. On the UniFi API key and UniFi username and password paths, Download limit (Mbps) and Upload limit (Mbps) set an optional speed limit per guest. Leave them blank for unlimited.
  8. The Cisco path shows a Controller software choice: IOS-XE (Catalyst 9800) or AireOS (legacy WLC). It decides which config pack you get on the next step.
  9. Click Continue.

For UniFi Remote Tunnel, Aruba Instant On, Cisco Meraki, Cisco Catalyst and Fortinet FortiAP the venue is created as soon as you click Continue, because the next step needs values that belong to it.

Path: CaptiFi Plug & Play ​

Delivery and payment ​

  1. Enter the delivery name, address and a phone number for the courier.
  2. Enter your card in the secure card form. A refundable deposit is taken now, in your billing currency (see Hardware), and returned when you send the device back.
  3. Click Place order.

If the deposit is declined, the message says your card was saved but the deposit was declined, and asks you to use another card or contact your bank. The card form comes back ready for another card and the delivery address you typed stays filled in, so enter the other card and click Place order again.

Your order confirmation prints as a receipt showing the order number, the deposit taken and your activation PIN. Write the PIN down: you enter it on the device when it arrives, and it is emailed to you as well. If you leave the wizard and come back to this step, the receipt is still there, with the deposit shown as Charged to your card.

The set-up wizard Delivery and payment step after the order, with the receipt showing the order number, the deposit and the activation PIN above the Continue setup button

  1. Click Continue setup, then complete the venue step so everything is ready the moment the device arrives.

Activate WiFi ​

The final step confirms the venue is created. Click Finish setup to open your dashboard. When the device arrives, follow the Quick Start to plug it in and enter the PIN.

Path: UniFi API key ​

The step is headed Connect with a UniFi API key.

  1. Controller name: optional, a label for your own reference.
  2. Controller address (reachable from the internet): the public IP address or hostname of your console. CaptiFi finds the right port itself, checking ports 443, 8443 and 11443, which can take up to 40 seconds. A console behind another router with no public address needs the UniFi Remote Tunnel card instead.
  3. API key: paste the key from UniFi Network. Click Show to check it before you connect. If you have not made a key yet, open Where do I find my API key? under the field for the steps.
  4. Click Connect controller. CaptiFi signs in with the key and discovers your UniFi sites.

Then complete the venue step. The Activate WiFi step pushes the guest network and splash page to your controller and reports when it is done. Finish setup unlocks once the guest network is live. If the push fails, click Retry setup, or click Back and check the controller details you entered.

The full UniFi guide, including how to create the key and open your console to CaptiFi, is at Connect UniFi to CaptiFi.

Path: UniFi Remote Tunnel ​

The tunnel is for consoles CaptiFi cannot reach from the internet. Your console dials out to CaptiFi instead, so no port forwarding is needed.

Install the tunnel ​

The set-up wizard tunnel step showing the one-line install command with a Copy command button and the waiting status

  1. Click Copy command. The command is unique to this venue.
  2. Turn on SSH on your console: Settings, Control Plane, Console, switch SSH on and set an SSH password.
  3. From any computer on the same network, run ssh root@YOUR-CONSOLE-IP, paste the command and press Enter.
  4. Leave the page open. It checks every five seconds and shows Tunnel connected on its own, usually within 30 seconds. Continue stays greyed out until then.

You can also paste the command into the Debug console in UniFi instead of using SSH: go to Devices, select the console, then open Settings and Debug.

Pasting on a Windows PC

In the UniFi Debug console, paste with Ctrl+Shift+V. Ctrl+V on its own does not paste there.

The step-by-step with every console variation is in the UniFi guide under Path B: Remote Tunnel.

Connect with API key ​

  1. In UniFi Network go to Settings, Integrations (before version 10.1: Settings, Control Plane, Integrations) and click Create API Key. Copy it straight away, it is only shown once.
  2. Paste it into the UniFi API key field and click Connect controller. The same steps are under Where do I find my API key? below the field.

The key is stored encrypted and never shown again. One click wires the server connection, the controller site and the splash configuration.

Go live ​

  1. The page lists the WiFi networks on your controller with how many devices are on each. Pick the one guests should sign in on, or choose Create a new guest SSID and type its name.
  2. Read the warning: every device on the network you gate is walled behind the splash page as it reconnects. Printers, tills and music players cannot complete a splash page, so gate a guest-only network.
  3. Click Go live. CaptiFi applies the portal and gates the network.
  4. Click Finish setup.

Set-up finishes when a network is live behind your splash page, so there is no way to skip this step. If you are not ready to gate a network yet, close the page. The wizard opens on Go live the next time you sign in.

After you finish ​

The finishing screen ends with the one thing to do next: join your guest WiFi with the phone in your hand and sign in as a guest. Your first guest shows on the dashboard within a minute, and the Your first guest card on the dashboard ticks off as you go.

If two days pass after you finish and no guest has signed in, CaptiFi emails you once to ask you to run that test yourself, naming your venue and your WiFi network. If the WiFi page does not open on your phone, or the sign-in does not go through, reply to that email with what you saw and we check the device and the page from our side.

Path: UniFi username and password ​

  1. On Find your UniFi controller, enter the Controller address (reachable from the internet): the public IP address or hostname of your controller. Click Test connection. CaptiFi checks it is reachable and really is UniFi before asking for a login.
  2. On Connect your UniFi controller, enter the Controller name, Controller username and Password for a local admin account. Tick This account has two-factor authentication (2FA) enabled if it does, then enter the six-digit code when asked. Which UniFi login should I use? under the form explains how to make a local admin account if you do not have one.
  3. Click Connect controller.

Then complete the venue step and Activate WiFi as for the API key path.

  1. Controller URL: a public IP or domain CaptiFi can reach, port 8043 by default.
  2. Controller ID: the long id segment from your Omada controller URL.
  3. Operator username and password: a dedicated operator account.
  4. Click Connect controller.

The same step has a section headed List your access points in CaptiFi (optional), with Client ID and Client Secret fields for an Omada Open API app. Fill them in and the venue's access points are listed on the Access Points page, with their status refreshed every 15 minutes, and its connected guests on the Connected Guests page. The role you give the app in Omada decides what else CaptiFi can do: a Viewer-role app lists access points and connected guests, and an Admin-role app also lets CaptiFi set up the portal for you, rename the guest network, apply your bandwidth limits and disconnect a guest. You can leave the fields empty and add the details later from the venue's card on My Venues. See Give CaptiFi Open API access for how to create the app in Omada.

Then complete the venue step. The Activate WiFi step shows the portal URL to enter on your Omada controller. See TP-Link Omada for the controller-side steps. Under the address, Connection checks turn green as a phone joins the guest WiFi and signs in. Finish setup unlocks once they are green.

When the app you gave at the connect step has the Admin role, the Activate WiFi step also has a Let CaptiFi set up the portal card under those instructions. Click Choose the guest WiFi network and pick the SSID guests sign in on, then click Set up the portal for me. CaptiFi creates the portal on your controller pointing at your venue's address, adds the pre-authentication entries that are missing and applies your bandwidth limit, then lists what it did, and the Connection checks under the address show the same controller checks as the venue card. The manual instructions stay on the page. With a Viewer-role app the card says so and explains how to move to Admin from the venue card on My Venues. See Let CaptiFi set up the portal for you.

Path: Ruckus Unleashed ​

  1. Controller name: a label for your Ruckus controller.
  2. Click Continue.

Then complete the venue step. The Activate WiFi step lists everything Unleashed needs, under Point your controller here, each value with its own Copy button:

  1. Portal URL: the Login Page for your Hotspot Service.
  2. Allowed domains (walled garden).
  3. Start Page (redirect to the following URL): the connected page guests land on after signing in.
  4. Under RADIUS server: the RADIUS server, Authentication port, Accounting port, NAS identifier and Shared secret, the secret masked until you click Show. The line under the heading says where they go in Unleashed.

The set-up wizard Activate your WiFi step for Ruckus Unleashed showing the portal URL, allowed domains, Start Page and the RADIUS server block, each value with a Copy button and the shared secret masked

  1. Under NAS-ID on the guest WLAN, the step gives the lines to enter over SSH on your Unleashed master access point, in two parts: 1. Open the guest WLAN and 2. Set the NAS-ID and save. The Unleashed web pages have no field for the NAS identifier, which is why it goes in this way.
  2. Connection checks at the bottom turn green as your controller and the first guests reach CaptiFi. Finish setup unlocks once they are green.

The Ruckus guide covers the controller side step by step.

Path: Aruba Instant On, Cisco Meraki, Cisco Catalyst 9800, Fortinet FortiAP ​

These controllers are configured on the vendor's side. The wizard generates every value you need and then watches for the first traffic from your controller.

Configure your controller ​

The set-up wizard Configure your controller step for Aruba Instant On, listing the portal URL, RADIUS server, ports, shared secret, NAS identifier and walled garden with copy buttons, and the Check my connection button

  1. Each value has its own Copy button: the portal URL, the RADIUS server and ports, the shared secret, the NAS identifier, the CoA port and redirect ACL name for Cisco, and the walled garden domains as one block. Copy everything copies the whole pack as plain text for your network team.
  2. Click Open the step by step guide for the vendor guide with a screenshot per click: Aruba Instant On, Cisco Meraki, Cisco Catalyst 9800 or Fortinet FortiGate / FortiAP.
  3. Enter the values on your controller.
  4. Click Check my connection.

The values stay available after the wizard: open More on the venue's card under My Venues, choose Connection and look under Controller settings. Nothing is lost if you close the page.

Check the connection ​

The set-up wizard Check the connection step for Aruba Instant On: Controller sending RADIUS traffic and Guest device reached the splash page both Waiting with their hints, Guests completing the splash page with a grey question mark, Not checked yet, waiting on the check above, a note that Finish setup unlocks when every check is green, and the Finish setup button greyed out

The page lists what CaptiFi has seen from your controller and refreshes every ten seconds:

  • Controller sending RADIUS traffic (Aruba, Cisco and Fortinet): turns green when the first authentication request arrives. If it stays pending, check the shared secret and NAS identifier match exactly and that UDP 1812 and 1813 are allowed out.
  • Guest device reached the splash page: turns green when a phone on the guest WiFi loads your sign-in page.
  • Guests completing the splash page: turns green when the first guest signs in.

The checks are listed in the order they depend on each other. A check that cannot run until another passes shows a grey question mark, Not checked yet and what it is waiting on, for example Waiting on the check above., instead of its own status. Start with the first check that is not green: its hint says what to look at. A check that has found a problem of its own, such as rejected requests, always shows it.

Connect a phone to the guest WiFi and complete the splash page to light all of them. Finish setup is greyed out until they are green. When they are, Connection verified shows above the list and the button unlocks.

If you are not at the venue, close the page. The wizard opens on this step the next time you sign in, with everything you entered still there.

Path: Other hardware ​

Choose this when your WiFi brand has no card of its own. One screen, Tell us about your WiFi hardware, asks for:

The set-up wizard Tell us about your WiFi hardware step, with the venue name, brand, model, how it is managed, the controller name and notes fields, and the What happens next box above Send to support

  1. Venue name: your business name is filled in for you.
  2. Brand: type it, or pick one of the common brands offered as you type.
  3. Model (optional): on the label on the access point or router, if it is to hand.
  4. How is it managed?: on each access point or router, a controller at the venue, a cloud dashboard, or not sure. For a controller or a cloud dashboard you can name it, for example DrayTek VigorACS or Zyxel Nebula.
  5. Anything else we should know (optional): how many access points there are, or who looks after your network.

Click Send to support. CaptiFi creates your venue straight away and opens a support request with these details. The screen then shows the request number and what happens next:

The Other hardware step after sending, with Sent to support, the request number, the three steps of what happens next and the Finish setup button greyed out until a guest has signed in

  • Our support team emails you, usually within one working day, with the settings for your hardware.
  • Once the settings are on your hardware, join the guest WiFi with a phone and sign in.
  • Finish setup unlocks then, and your dashboard opens. The page checks every 10 seconds.

You do not have to keep the page open. Close it and sign in again once your hardware is set up: the wizard opens on this screen. After set-up you can follow the request, and reply to it, under Guides & support.

Finishing ​

Finish setup is on the last step of every path. It stays greyed out until your guest WiFi is confirmed working, and the step says what it is waiting for:

PathWhat unlocks Finish setup
UniFi API key, UniFi username and passwordCaptiFi sets up the guest network on your controller. The Activate WiFi step reports when it is live.
UniFi Remote TunnelGo live gates the network you chose.
TP-Link Omada, Ruckus Unleashed, Aruba Instant On, Cisco Meraki, Cisco Catalyst 9800 / AireOS, Fortinet FortiAPA phone joins the guest WiFi and signs in through your splash page, so the Connection checks turn green.
Other hardwareA phone joins the guest WiFi and signs in, once our support team has sent you the settings for your hardware.
CaptiFi Plug & PlayNothing to confirm in the wizard. Your device is on its way.

You do not have to do it in one sitting. Close the page whenever you like: the next time you sign in, the wizard opens on the step you were on.

If you go back and choose different hardware, or connect a different controller, Finish setup waits for the new connection to be confirmed in the same way. A sign-in from before the change does not count for it.

When you click Finish setup, CaptiFi runs through a short checklist on screen: it checks the connection to your controller or device, gets the venue ready, prepares your dashboard and then opens it. Each line ticks off as it completes and the bar above the list fills as it goes. The whole thing takes a few seconds.

After the wizard ​

Your dashboard opens on My Venues. From here:

  • Design your splash page: logo, colours, sign-in fields and questions, in the Splash page builder.
  • Watch guests arrive under Guests as soon as your device or controller is live.
  • Switch on integrations such as Google Reviews (Essentials and above) and Mailchimp (Growth and above) under Integrations. Integrations are not on Lite.

If a connection drops later, the venue card on My Venues shows the connection state and lets you reconnect the controller or push the WiFi settings again: open More on the venue card, choose Connection and click Change network to re-apply them once the controller is reachable.

CaptiFi: Guest WiFi Marketing Platform