Skip to content

Remote shell #

Remote shell gives you command-line access to a Linux device from your browser. No SSH port forwarding, no VPN, and no inbound firewall changes.

Commands run with the Linux permissions of the agent's configured OS identity. Dataplicity access roles decide who may open a session, but do not add Linux privileges. Support Engineer cannot open a shell; that is a device-action grant. See Support team access, Shell privileges, and the device-side privilege boundary.

Open the device workspace #

  1. Choose Terminal from Quick access and find the device by name or tags.
  2. Confirm the selected device's identity and online status. Use the full device identifier when names are similar.
  3. Choose Open a terminal, or New session beneath the selected device, to start a shell. Select an existing Terminal 1 or Terminal 2 entry to return to that session.
  4. Use Device tools beneath the identity card to inspect the unit without losing the device context. Terminal sessions remain listed separately.
SiloSentry Gateway device workspace with session list, read-only check results, Pinguïno assessment and working terminal
Illustrative Northstar demo: the current workspace keeps the selected device, its sessions, a quick device check and the working terminal together.

Start with a quick device check #

When Pinguïno is available, choose Run read-only check in the device conversation. This opens a Working terminal alongside the conversation and gathers a bounded snapshot of load, processes, memory, filesystem space and network configuration. The result includes an assessment and the terminal output used for the check. Use Take over to work in that terminal yourself.

Read the result as evidence from the time of the check. Load averages are not CPU utilisation, available memory is not the same as unused memory, and a successful DNS lookup does not prove that the application service is reachable. Verify recovery through the relevant application, logs or monitor.

The check uses terminal access even though its commands are read-only. It requires a connected device and permission to use that access path. Pinguïno availability also depends on your organisation's assistant access. If it is unavailable, use Open a terminal or the available Device tools directly.

Ask about one terminal #

Open a session and choose Help with this terminal to ask about its output or prepare the next command. Review the context you include and the proposed command before running it. Keep commands tied to the intended device and session; opening help does not itself run a command.

Production guides #

GuideDescription
Shell privilegesUnderstand and safely extend device permissions.
Copy and pasteClipboard support in the terminal.
Process monitoringSee what is running during diagnosis.
Dataplicity LensStructured host inspection from the same shell session.
Run scripts in backgroundLong-running processes.
Control remote accessPlan customer-approved support access.

Confirm the session works #

To prove a new shell, run a read-only command such as htop. Optional first-session demos (device speech, ASCII Star Wars) are not production support workflows.

For web application access and resilient file retrieval, see Remote access.