Skip to content
Install

Get started

In this guide, you create a Greenhouse machine, give it a credential for a coding agent, and start a first session on one of your repositories. When you finish, an agent works on its own branch on the machine, and you can review its changes in the workspace.

  • An Orchard instance with the greenhouse graft installed. If Greenhouse is not in the dashboard sidebar, refer to Troubleshooting Greenhouse.
  • Membership in an organization. Organization guests cannot create machines.
  • A GitHub account linked to Orchard, to clone private repositories and open pull requests. Link it in Account settings > Connections.
  • The Orchard CLI, if you use the CLI steps.

Orchard requires an SSH key to create a machine. Editors and ssh use the key to connect.

  1. Go to Account settings > Greenhouse.
  2. Under SSH identities, select Add identity. To use the keys on your GitHub profile, select Import from GitHub instead.
  3. Paste a public key.

The default agent uses your Claude token when you have one. Claude Code requires it.

Create a token on any computer with Claude Code installed:

claude setup-token

Store the token in Orchard:

  1. Go to Account settings > Greenhouse.
  2. Under Agent credentials, paste the token into the Claude Code field.
  3. Select Save.

Orchard encrypts the token and does not show it again.

For other agents and sign-in methods, open a running machine and go to Settings > Agents.

  1. In the dashboard sidebar, select Greenhouse.
  2. Select New machine.
  3. (Optional) Enter a Name. It must be a lowercase DNS label of up to 63 characters. Orchard generates a name if you leave it empty.
  4. If the instance offers more than one runner, select one under Runs on.
  5. If you have more than one SSH identity, select one under SSH key.
  6. Select Continue.
  7. Select a repository to clone on first boot. To add a repository later, select Skip.
  8. Select Continue.
  9. (Optional) Enter a Setup script. It runs once, on the first boot of the machine.
  10. Select Create machine.

The machine status changes from Creating to Starting to Running.

The first boot on an image without the required tools takes a few minutes. Orchard installs the tools during that boot.

If Orchard reports Sandbox limit reached, ask a superadmin to raise your limit. The default limit is one machine.

  1. Open the machine. When it is Running, the home page shows What should we build?.
  2. Below the prompt, select the repository for the session.
  3. Enter what the agent should do.
  4. (Optional) To have the agent propose a plan without editing files, change Build to Plan, read only.
  5. Select Start session, or press ENTER.

Greenhouse creates a git worktree on a new branch named orchard/<slug> and sends your prompt to the agent. The session appears in the sidebar under its repository, and its row shows what the agent is doing.

To run another agent at the same time, start another session. Each session has its own branch and worktree.

  • Machines - Learn what each runner provides, what persists across a stop, and which limits apply.
  • Connect an editor over SSH - Open a session in VS Code, Cursor, or Zed.
  • Share a machine - Invite people from your organization to work on the machine with you.