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

  • If the host cannot be found, confirm the environment is running and copy the host again from the environment details page.
  • If SSH fails, rerun ona env ssh-config on your local machine and check that ~/.ssh/ona exists.
  • If the repository opens but tools are missing, 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.