> ## 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](https://ona.com/docs/ona/integrations/cli.md).

## Prerequisites

1. [Zed](https://zed.dev/download) installed.
2. The [Ona CLI](https://ona.com/docs/ona/integrations/cli.md) 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] Host cannot be found
>
> Confirm the environment is running and copy the host again from the environment details page.

> [accordion] SSH fails
>
> Rerun `ona env ssh-config` on your local machine and check that `~/.ssh/ona` exists.

> [accordion] Repository opens but tools are missing
>
> The issue is usually in the environment configuration rather than in Zed itself.

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.