Control Interface Wizard (control-wizard)

The control-wizard is a command-line tool for network configuration on a Beam device. It provides a text-based wizard to configure the primary Control interface, set up an HTTP proxy, and diagnose connectivity issues.

This tool is especially useful during the initial setup of a device before the web UI is accessible, or for troubleshooting network problems directly from the terminal.

Aliases

For convenience, you can use shorter commands:

• cw is an alias for control-wizard.
• cs is an alias for control-wizard --status, which runs the wizard in a read-only monitoring mode.

When to use the wizard

You can use the control-wizard to:

• Set the IP address for the Control interface during initial device setup.
• Configure an HTTP proxy if one is required to connect to MK.IO.
• Diagnose network connectivity problems from the terminal.
• View a real-time display of network interface status.

Configure the Control IP Address

During the initial quick start, if the device has not obtained an IP address via DHCP, you must use control-wizard to set one manually.

1. Log in to the terminal with the default credentials.
2. Type control-wizard (or cw) and press Enter.
3. Follow the on-screen prompts to configure the IP address, subnet mask, and gateway for the Control interface.

Configure an HTTP Proxy

If the device requires an HTTP proxy to reach the internet to connect to MK.IO, you can configure it from the wizard.

Diagnose and View Network Status (cs)

The cs command provides a read-only, real-time view of network status, which is useful for diagnosing connectivity issues and monitoring interface state. It is an alias for control-wizard --status.

When you run cs, it displays both the connectivity status to the MK.IO API and the state of local network interfaces, including IP addresses and traffic. This is a useful first step when troubleshooting on-boarding issues.

To use the status viewer, type cs in the terminal and press Enter.