> ## Documentation Index
> Fetch the complete documentation index at: https://ona.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Zed

> Connect to Ona environments using Zed editor via SSH.

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](/ona/integrations/cli).

## Prerequisites

1. [Zed](https://zed.dev/download) installed.
2. The [Ona CLI](/ona/integrations/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

<Accordion title="Host cannot be found">
  Confirm the environment is running and copy the host again from the environment details page.
</Accordion>

<Accordion title="SSH fails">
  Rerun `ona env ssh-config` on your local machine and check that `~/.ssh/ona` exists.
</Accordion>

<Accordion title="Repository opens but tools are missing">
  The issue is usually in the environment configuration rather than in Zed itself.
</Accordion>

See [Zed remote development docs](https://zed.dev/remote-development) and the [Ona CLI](/ona/integrations/cli) page for more.