Subshell Docs

Manage nodes

Enroll other machines so your server can launch agents on them.

A node runs the subshell daemon. It connects outward to the server, receives signed commands, and sends terminal output back. Your browser continues to connect to the server.

Add a machine

Use Subshell Client for most node installations. It bundles the node binary and provides the enrollment and management window.

Enrollment and execution

The setup key enrolls the machine; the node then uses its own credential for its connection. A browser-only device doesn't need enrollment.

Control access

Directory restrictions limit where new sessions can launch. Share a node controls which users can run sessions there.

Enrollment trust

Enrolling a machine delegates agent execution to the control plane. Agents run with the node account's permissions; command signing doesn't sandbox their filesystem access.

Operate a node

Use Manage a node for runtime and log details, Node services for persistence, and Node maintenance before disruptive work.

For relocation or removal, read Repoint a node and Unenroll a node.

Edit on GitHub

Last updated on

On this page