Change a CPE's parameters via ACS
Goal: change the customer's device settings (WiFi, WAN, LAN…) remotely, over TR-069, directly from Cpehub.
When a CPE is communicating with Cpehub's ACS, you can read and change its parameters remotely — for example, change the WiFi network name (SSID) and password without needing to visit the customer.
Prerequisites
Check off items as you go. This is just a visual aid, so reloading the page unchecks everything again.
- The CPE has TR-069 active (communicating with the ACS). If the WiFi/WAN tabs show "TR-069 required", configure it first at Configure TR-069.
Two ways to change it
1. Through the friendly tabs (recommended)
The simplest way is to use the ready-made tabs on the CPE detail screen, which already show the fields in an organized way:
- WiFi tab — SSID, password, channel, band.
- WAN tab — PPPoE/IP connections, service ports.
- LAN tab — local DHCP, ports.
Step by step (e.g., changing WiFi):
- Open the CPE and go to the WiFi tab.
- Click Sync to load the current configuration.
- Change the desired field (e.g., SSID or password).
- Save. The change enters the Execution Queue and is applied to the device.
2. Through the ACS tab (advanced)
The ACS tab gives access to the device's raw TR-069 parameter tree. Use it when you need a specific parameter that isn't in the friendly tabs. Requires knowing the device's data model (TR-098 or TR-181) — see Supported TRs.
Changing raw parameters can leave the customer offline if the value is wrong. Prefer the friendly tabs; use the ACS tab with care and test on one device before applying it in bulk.
Applying to several CPEs at once
To change many devices at the same time, use Automations (by trigger) or Scripts (in bulk).
Common issues
| Symptom | Cause | Solution |
|---|---|---|
| Tab shows "TR-069 required" | CPE without ACS | Configure TR-069 |
| I changed it and it didn't apply | Pending/failed job | Check the Execution Queue |
| Value reverted on its own | Automation/preset rewriting it | Check active automations and presets |