Skip to main content

2.3.2 Add device via SSH

SSH is the most universal device entry in RDK Studio. If your host is reachable from this PC over the network and SSH is running, you can add it as a device.

It works for RDK boards and for generic Linux hosts, Jetson, Raspberry Pi, Rockchip, and other remote machines.

Add device dialog: SSH configuration form

Step 1: Gather connection details

FieldDescription
Host / IPDevice address or hostname
PortDefault 22; leave default if unsure
UsernameOfficial RDK images often use root; other Linux as appropriate
PasswordQuick path for first connect
Device aliasShown in the device list and Moss workspace

If you do not know the Host / IP, check the router admin UI, OS network panels, or serial boot log. Moss can also help scan the LAN.

Step 2: Add the device

  1. Open Add device → SSH device.
  2. Enter Host / IP, port, username, and password.
  3. Click Connect. RDK Studio verifies SSH, then saves the device.
  4. For RDK or similar boards, you may be prompted for Wi-Fi setup after verification.

Once saved, workbench, terminal, files, code editor, remote desktop, and Moss all use this connection.

Step 3: Confirm device type

RDK Studio classifies the host. Available capabilities vary:

ClassificationTypical capabilities
RDKRDK hardware context, Wi-Fi setup, flashing links, OpenClaw deploy
Generic LinuxMoss, terminal, files, code editor, project workspace
Jetson / Raspberry Pi / RockchipGeneric Linux; board-specific extras as supported
UnknownConservative generic UI to avoid wrong RDK-only flows

Common addresses

ScenarioAddress
After Type-C direct192.168.128.10
Ethernet or fixed imagePer your image documentation
Wi-Fi / DHCPAssigned by the router; look it up

Connection failures

SymptomWhat to do
TimeoutPower on the device; verify Host / IP; ensure L2/L3 reachability
Auth failureCheck username/password; confirm whether defaults were changed
Connection refusedRemote login service may be off; enable via serial if needed
After reflash still failsRemove stale saved entries and connect again

Full troubleshooting: 5.2 SSH connection failed.

Next steps

After a successful add, configure Wi-Fi if needed, or ask Moss on the workbench: “Check this device’s system summary and suggest next steps.”