Skip to content
Install

Manage SSH identities

An SSH identity is a named public key on your account. Add one to connect to a Greenhouse machine from your own terminal or a local editor, such as VS Code or Zed over SSH. Orchard stores only the public key and never receives your private key.

Use this option if you do not need a specific key. The following command generates a key for Orchard and registers it as an identity:

orchard sandbox ssh-config --install

The command also adds an orchard-* entry to ~/.ssh/config, so ssh orchard-<MACHINE_NAME> works. To connect an editor this way, refer to Connect an editor over SSH.

  1. Go to Account settings > Greenhouse.
  2. In SSH identities, select Add identity.
  3. In Name, enter a name, such as laptop.
  4. In Public key, paste your public key.
  5. Select Add identity.

Orchard reads https://github.com/<username>.keys for your linked GitHub account and creates one identity for each key.

  1. Go to Account settings > Greenhouse.
  2. In SSH identities, select Import from GitHub.

Orchard refuses to remove an identity that is attached to a machine. The error names the machine:

Identity is attached to sandbox "my-machine"; detach it first
  1. Attach another identity to the machine:

    orchard sandbox update <MACHINE_NAME> --identity <OTHER_IDENTITY>
  2. Remove the identity:

    orchard ssh-identity remove <IDENTITY_NAME>
  1. Add the new key as a new identity.
  2. Attach the new identity to your machines.
  3. Confirm that you can connect with the new key.
  4. Remove the old identity.