UNpkl EasyMesh

Extend Wi‑Fi coverage across your home or office with UNpkl **EasyMesh**—one shared network name, secure mesh backhaul, and automatic routing to the main gateway (**controller**).

Tip

UNpkl devices ship as controllers by default. A mesh package of three may arrive with two agents and one controller already configured—skip agent pairing for those units.

Overview

EasyMesh is relevant when you add UNpkl Wi‑Fi access points that should work as agents (mesh extenders) under a single controller gateway.

In plain terms, an EasyMesh agent is a Wi‑Fi extender with stronger security than a typical repeater: agents discover the controller automatically, use encrypted backhaul links, and inherit Wi‑Fi settings from the controller once paired.

Typical layout:

  • Controller — the UNpkl gateway connected to your ISP (WAN). It runs policy, DHCP, and cloud sync.
  • Agent(s) — ceiling‑mount or PoE access points that extend coverage. Clients roam between controller and agents on the same SSIDs.

Common sizes:

  • 1 controller + 1 agent
  • 1 controller + 2 agents (common retail mesh package)
  • 1 controller + 3 or more agents for larger floors
EasyMesh layout with one controller, Wi-Fi mesh backhaul, and two agents
One controller on the WAN; agents join over encrypted Wi‑Fi mesh backhaul.

Enterprise deployments often use a UNpkl Gateway controller, a PoE switch, and multiple AP103 (or compatible) ceiling agents—see UNpkl SaaS for that workflow.

Controller and agent roles

Every UNpkl unit can act as either:

  • Controller — main router on your WAN link; owns the mesh and customer Wi‑Fi networks
  • Agent — extends Wi‑Fi; connects to the controller over a private backhaul SSID

Each mesh uses a unique backhaul SSID and PSK secret (printed in the brochure shipped with each device). The agent must use the controller’s backhaul credentials—not its own factory brochure values—before you run turn agent on.

Router brochure showing backhaul SSID and backhaul PSK for mesh setup
Save the controller brochure in a secure place; you will copy its backhaul SSID and PSK onto each agent.

UNpkl configures controllers at the factory with turn controller on, so you usually do not need to change the controller role yourself.

What you need

Buy two or more UNpkl Wi‑Fi access points when you want mesh coverage (one gateway plus at least one agent).

Access points are available from the UNpkl store or authorized retailers. For wired backhaul to agents, use a PoE switch so power and data share one cable run to ceiling mounts.

You will need:

  • The controller brochure (router connected to the ISP)
  • Each agent brochure (for that unit’s factory backhaul SSID and PSK, before you retarget it)
  • The UNpkl mobile app or local web UI with Search for setup commands

Set up the controller

  1. Complete Initial setup on the gateway that will be your controller (WAN, admin login, Wi‑Fi).
  2. Confirm it has internet access and that you can open Search on the app or web UI.
  3. Leave the device in controller role (factory default).

If you are unsure, open Live data → Topology after agents join—you should see the controller at the top of the mesh tree.

Set up an agent

Configure one agent at a time. Use the brochure from the agent’s box for its current backhaul name and secret, and the controller’s brochure for the target values.

Connect to the agent

  1. Connect your laptop or phone to the agent you are configuring—preferably over Ethernet to the agent’s LAN port. If you use Wi‑Fi, be sure you joined that agent’s network, not the controller’s.
  2. Sign in to the UNpkl app or web UI on the agent.
  3. Open Search.

Point the agent at the controller backhaul

From the agent’s Search box, run two commands (replace placeholders with values from the brochures):

  • change wifi setting ssid for <Current Backhaul SSID> to <Controller Backhaul SSID>
  • change wifi setting psk for <Current Backhaul PSK> to <Controller Backhaul PSK>

Example (names will differ on your devices):

  • Agent brochure might show Backhaul SSID: UNpkl-AP-123456-1 and Backhaul PSK: abcdefghijklmnop
  • Controller brochure shows Backhaul SSID: UNpkl-AP-654321-1 and Backhaul PSK: qrstuvwxyz123456

Use the agent’s current SSID as the for name in both commands, and paste the controller’s SSID and PSK as the to values.

Enable the agent role

In Search on the agent, run: turn agent on

The device reboots, joins the controller over Wi‑Fi backhaul, and imports Wi‑Fi settings from the controller. Repeat for each additional agent.

Important

After the next step the unit becomes an agent and cannot be switched back to a controller without advanced manual steps. Double‑check that backhaul SSID and PSK match the controller brochure, not the agent brochure.

Verify in the app

After agents come online:

  1. Connect to the controller network (or sign in to your cloud account).
  2. Open Live data → Topology.
  3. Confirm Controller at the root and Agent nodes linked below it, then client devices attached.

In UNpkl Cloud, the Live tab shows the same topology and connection charts for fleet deployments.

Placement tips

  • Mount agents between the controller and areas with weak signal—not at the far edge of coverage.
  • Prefer line of sight where possible; avoid metal racks, concrete pillars, and microwave ovens between nodes.
  • For ceiling APs, center agents over the floor area they should serve.
  • If clients stick to one node, move the agent closer to the dead zone or add another agent mid‑path.

See Troubleshooting if roaming is poor or an agent never appears in topology.

Mesh commands

Use Search on the controller or agent (while locally connected) for mesh role commands:

  • turn mesh on
  • turn agent on
  • turn controller on
  • turn mesh controller on

Full phrase lists and SAC behavior are in Search & command.

Bulk agent setup

If you are onboarding many agents (for example a full office rollout), contact UNpkl support—we can provide scripts to automate backhaul retargeting and turn agent on instead of stepping through the UI for each unit.