Skip to main content
Zed connects to Ona environments over SSH. It does not use the one-click open flow in the dashboard, so setup requires the Ona CLI.

​
Prerequisites

  1. Zed installed.
  2. The Ona CLI installed.

​
Connecting to an environment

  1. Run ona env ssh-config to configure your local SSH settings. Verify ~/.ssh/ona exists after running.
  2. Start an environment in Ona. Copy the SSH host from the environment details page. The format is <environment-id>.ona.environment (e.g., 01922350-2462-79da-8c80-770fe4275aa2.ona.environment).
  3. In Zed, open the remote projects dialog (Cmd+Shift+P, type remote). Add a connection using the SSH host.
Once connected, you have access to the repository, tools, and services in the environment. Ensure the environment has started before connecting.

​
Troubleshooting

Confirm the environment is running and copy the host again from the environment details page.
Rerun ona env ssh-config on your local machine and check that ~/.ssh/ona exists.
The issue is usually in the environment configuration rather than in Zed itself.
See Zed remote development docs and the Ona CLI page for more.