System Commands
Device information, diagnostics, updates, and system management from the shell
Device Information
info
Display a summary of device hardware and software information.
infoshow version
Display the firmware version, device model, and unique identifier.
show versionOutput includes:
| Field | Description |
|---|---|
| Firmware Version | The currently running firmware release |
| Device Model | Hardware model identifier (e.g., BXE2150C) |
| Device UUID | Unique device identifier used by the Simplifyd Cloud |
VPN Tunnel Status
status
Show the current state of the secure cloud tunnel.
statusOutput includes:
| Field | Description |
|---|---|
| Interface | The tunnel interface (typically tun0) |
| AID | Assignment ID for this device in the Simplifyd network |
| IP Address | The tunnel IP assigned to this device |
| MTU | Maximum transmission unit for the tunnel |
| Running | Whether the tunnel is active |
Diagnostics
ping
Test connectivity to a host from the device.
ping <hostname-or-ip>Example:
ping 8.8.8.8Example output:
64 bytes from 8.8.8.8 ttl=55 time=12.4ms
64 bytes from 8.8.8.8 ttl=55 time=11.9msPress Ctrl+C to stop.
logs
Stream live log output from a system service.
logs <service>Available services:
| Service | Description |
|---|---|
vpnd | VPN tunnel daemon |
netconfigd | Network configuration daemon |
websocket | Cloud communication bridge |
wifi | WiFi management daemon |
dhcp4d | DHCP server |
updater | Firmware update service |
Example — tail the VPN daemon log:
logs vpndPress Ctrl+C to stop streaming.
Security
password
Set the SSH login password for the device. This password is also required to enable remote packet capture from the dashboard.
password <new-password>Example:
password myNewP@ssChoose a strong password. This credential grants shell access to the device. If SSH is enabled in the topology settings, anyone with this password and network access to the device can log in.
System Configuration
set api-url
Configure the API server the device connects to. Useful in air-gapped or private cloud deployments.
set api-url <host:port> [--secure]| Argument | Description |
|---|---|
<host:port> | The hostname and port of the API server |
--secure | Use a TLS-secured WebSocket (wss://) instead of ws:// |
Examples:
set api-url api.example.com:9999
set api-url api.example.com:443 --secureThis setting is configured automatically during provisioning and should only be changed if you are running a private Simplifyd deployment.
set system-tunnel-route
Define the IP range assigned to the Simplifyd Cloud infrastructure. See Routing for details.
Firmware Updates
update
Trigger a firmware update. The device will download and apply the latest firmware release from Simplifyd's update server.
updateTo update from a custom server (for testing or private deployments):
update <server-ip>Example:
update 192.168.1.50The device will automatically reboot after a successful firmware update to apply the new version.
Power Management
reboot
Restart the device. All active connections will be briefly interrupted while the system restarts.
rebootshutdown
Power the device off. The device will need to be physically powered on again to restart.
shutdownshutdown cuts power to the device. Ensure you have physical or out-of-band access before running this command in a remote session.
