SSH / Remote Display with Namespace Compute

Remote Display

Namespace supports visual debug access through multiple options which is invaluable for debugging GUI applications, testing user interfaces, and investigating display-related issues.

VNC Integration

Access your Mac runners through Remote Display (VNC) directly from the Namespace dashboard.

You can also start a VNC session using our CLI:

nsc vnc <instance-id>

VNC support is currently available for macOS runners. Support for other platforms is in development.

RDP Access

To gain interactive, visual access to your Windows runners, you can rely on our RDP integration.

You can start an RDP session using our CLI.

nsc rdp <instance-id>

RDP credentials are printed on the CLI and currently need to be entered in the RDP client manually.

SSH Access

Connect to any running instance via SSH for command-line debugging and investigation. Perfect for examining file systems, running diagnostic commands, and troubleshooting build environments. The simplest path to jump into an interactive terminal is through your browser with our web SSH interface.

Alternatively, you can jump into an SSH session from your command line. To open an SSH session, you can use our CLI:

nsc ssh <instance-id>

To use native SSH, supply your public key when creating an instance:

nsc create --ssh_key ~/.ssh/id_ed25519.pub

and then connect to it using:

ssh <instance-id>@ssh.<region>.namespace.so

Note: If you'd like to use your GitHub SSH key with native SSH instead, reach out to our support team to get it enabled.

API Reference

SSH credentials can be obtained programmatically via the ComputeService GetSSHConfig RPC. It returns:

• A short-lived SSH private key with access restricted to the specified instance.
• The username and endpoint to connect to.

You can optionally specify a target_container to open an SSH session directly inside a specific container running on the instance.