What is ICX Setup?
ICX Setup is a macOS app that takes a RUCKUS ICX switch from the box to a managed, up-to-date deployment — without you memorising the FastIron CLI. You connect to the switch, the app reads its state, and then you pick an operation or run the whole sequence as one guided Full Deploy.
It is built for the people who actually rack switches: network engineers and installers working on RUCKUS ICX hardware over a console cable or SSH. Every operation is a wizard that drives the switch’s own CLI for you and shows you exactly what it’s sending in a live terminal drawer.
What it does
Section titled “What it does”| Operation | What it’s for |
|---|---|
| Assess | Read the switch’s model, firmware, stack state, and management status. See Assessing a switch. |
| Upgrade firmware | Move a switch to a target FastIron version, hopping through required intermediate releases automatically. See Upgrading firmware. |
| Build a stack | Turn standalone units into a stack over their stacking ports. See Building a stack. |
| Adopt to a platform | Configure management networking and point the switch at RUCKUS One or SmartZone. See Adopting to a platform. |
| Full Deploy | Run stack → upgrade → adopt → verify end-to-end from a deployment profile. See Full Deploy and profiles. |
How it connects
Section titled “How it connects”ICX Setup talks to the switch two ways:
- Serial console over a USB-to-serial cable — the way in for a factory-fresh switch with no IP yet. Ports are auto-detected.
- SSH over the network, once the switch has a management IP. SSH needs FastIron 9.0 or later; for older firmware, use the console cable.
Both paths are covered in Connecting to a switch.
Which switches
Section titled “Which switches”ICX Setup reads each switch’s model from show version and recognises eight
RUCKUS ICX families — ICX 8200, 8100, 7850, 7650, 7550, 7450, 7250, and
7150. All eight are assessed and adopted the same way; what differs is
stacking and firmware:
| Family | Assess & adopt | Build a stack | Upgrade firmware |
|---|---|---|---|
| ICX 8200, 7850, 7650, 7550, 7150 | Yes | Yes | Yes |
| ICX 8100 | Yes | Yes | Not yet — see Firmware versions |
| ICX 7450, ICX 7250 | Yes | No stacking data | Up to 09.0.10a |
Per-family version ranges, stack limits, and the hops an upgrade inserts are all in Firmware versions and upgrade rules.
Requirements
Section titled “Requirements”- macOS 15.0 or later.
- A USB-to-serial console cable to reach a factory-fresh switch over its console port, or network reachability for SSH once the switch has a management IP.
- For SSH, the switch must run FastIron 9.0 or later.
Safe by design
Section titled “Safe by design”ICX Setup is careful with both your switches and your secrets:
- Nothing is mutated until it’s safe. A firmware upgrade verifies every required image is present before it touches the switch, and Full Deploy skips any phase that isn’t needed (already-current firmware, no stack requested).
- Secrets live in the macOS Keychain — switch passwords and pinned SSH host keys, never in plain preferences.
- Session logs are redacted. Passwords and config secrets are masked before anything is written to disk.
- No account, no backend, no telemetry. The app talks only to the switch in front of you.
See Security and privacy for the details.
Explore the docs
Section titled “Explore the docs”Set up
Section titled “Set up”Workflows
Section titled “Workflows”Reference
Section titled “Reference”RUCKUS and ICX are trademarks of CommScope, Inc. ICX Setup is an independent tool and is not affiliated with, endorsed by, or sponsored by CommScope, Inc.
Need a hand? Contact support.