> This page is for Beam.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://mediakind.ferndocs.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://mediakind.ferndocs.com/_mcp/server.

# Control Interface 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.

* Log in to the terminal with the default credentials.

* Type `control-wizard` (or `cw`) and press Enter.

* 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.

### Open the proxy configuration

* Log in to the device’s terminal.

* Run the `control-wizard` command.

* Press P to configure a proxy.

### Enter proxy details

* Enter the Proxy IP Address, Port, Username, and Password when prompted.

* Press Enter to apply the settings.

### Verify and quit

* The wizard automatically tests the proxy settings, and the results are displayed on screen.

* Press Q to quit 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.

Running the full `control-wizard` (or `cw`) for configuration also shows the MK.IO API connectivity test on startup.