Skip to main content
Connect to your Devbox from your local environment using SSH, your preferred terminal, or a full IDE. All remote connections are tunneled securely through the Namespace API. No public IP addresses or open ports are required.

​
Prerequisites

Before connecting, make sure you have completed Getting Started — the Devbox CLI must be installed and authenticated. You’ll also need a running Devbox.

​
Terminal Access

​
Direct SSH

The fastest way to get a shell in your Devbox:
This establishes an interactive SSH session directly to your Devbox. Use the -A flag to forward your local SSH agent:

​
Configure SSH

To use the standard ssh command (and enable any tool that relies on SSH config), run:
This sets up your local ~/.ssh/config with an Include directive pointing to ~/.namespace/ssh/, writes the SSH key and a host config for your Devbox. After running this, you can connect with:
This also enables tools like scp, rsync, and any program that reads your SSH config.

​
Port Forwarding

Forward ports from your Devbox to localhost:
Remap ports with local:remote syntax:
If your Devbox has configured port forwards in its blueprint, running devbox port-forward main without --ports will forward all of them automatically.

​
IDEs

All IDE integrations connect over SSH. There are three ways to get started:
  • Dashboard: Open VS Code or Cursor directly from the Devbox dashboard.
  • Automatic: devbox open-ide configures SSH and opens your IDE in one step. Available for VS Code, Cursor, Zed, and others.
  • Manual: Run devbox configure-ssh first (see Configure SSH), then connect from your IDE using the SSH host. You may need to specify a working directory. Use /workspaces/{repo-name} if you created your Devbox with --checkout.

​
VS Code / Cursor

​
Open from the dashboard

  1. In the Devbox dashboard, click Open VSCode and choose VS Code (desktop) or Cursor (desktop)
VS Code installs the Namespace Devbox extension automatically. On first use, the extension will open your browser to authenticate with Namespace. Once authenticated, it connects to your Devbox.

​
Open from the CLI

Open your Devbox directly in VS Code or Cursor:
This will:
  1. Configure local SSH access to your Devbox
  2. Ensure the Remote - SSH extension is installed (see the VS Code Remote-SSH documentation for more details)
  3. Open a new window connected to your Devbox
You can also use --flavor vscode-insiders, --flavor codium, --flavor positron, --flavor windsurf, or --flavor zed.

​
JetBrains

JetBrains IDEs support remote development through JetBrains Gateway or the built-in remote development features in IDEs like IntelliJ IDEA, GoLand, PyCharm, and WebStorm. See the JetBrains remote development documentation for more details.
  1. Configure SSH access. This writes the SSH key and proxy config so Gateway can connect without manual setup:
  1. Open JetBrains Gateway and select SSH Connection
  2. Create a new connection with the host main.devbox.namespace and username devbox
  3. Select the IDE and project directory on the remote host
JetBrains Gateway installs the IDE backend on your Devbox and streams the UI to your local machine.

​
Zed

Open your Devbox in Zed:
This opens Zed with a remote SSH connection to your Devbox. Zed connects using its native SSH remote development support.

​
Next Steps

Sessions → Persistent terminal sessions that survive disconnections and Devbox restarts. Managing Devboxes → Lifecycle operations, machine sizes, workspace defaults, and monitoring. Custom Images → Build custom base images with your tools and runtimes pre-installed.
Last modified on August 19, 2026