logo

Device Shell Overview

Access and navigate the Simplifyd Box device shell for direct device configuration

The Simplifyd Box device shell is a command-line interface built into every Box router. It gives you direct access to the device for network configuration, diagnostics, and system management — useful when the dashboard is unavailable or when you need low-level access.


Connecting to the Shell

There are two ways to reach the device shell:

SSH

Connect over the network using SSH:

ssh admin@<device-ip>

Replace <device-ip> with the LAN IP address of the device (default: 192.168.200.1). SSH access must be enabled in the device's Topology settings panel and a password must be set with the password command.

Serial Console

Connect directly using a USB-to-serial cable plugged into the device's console port:

SettingValue
Baud Rate115200
Data Bits8
ParityNone
Stop Bits1

Use a terminal application such as PuTTY (Windows) or screen / minicom (Linux/macOS).


The Shell Prompt

Once connected, you will see the shell prompt:

wan-edge-<SERIAL> #

The serial number is derived from the device's MAC address and uniquely identifies each unit. For example:

wan-edge-1615561 #

Getting Help

Run help at the prompt to see all available commands:

wan-edge-1615561 # help

Command Reference

CommandDescription
showDisplay interface status, routing table, and version information
intfConfigure interfaces — IP address, DHCP, MTU, VLANs
add / rmAdd or remove IP addresses and routes
routeAdd or remove static routes
wifiConfigure the built-in WiFi access point
pingTest connectivity to a host
logsStream logs from a system service
statusShow VPN tunnel status
infoDisplay device information
passwordSet the SSH login password
setSet system-level configuration options
updateTrigger a firmware update
rebootReboot the device
shutdownShut the device down
historyView or clear command history

Session Features

  • Command history — use the up/down arrow keys to recall previous commands. History is saved to ~/.sesh_history.
  • Aliases — define custom command shortcuts in ~/.seshrc.
  • Tab completion — press Tab to auto-complete command names and arguments.