# Get started > Create your first Greenhouse machine and start a coding agent session on it. You need an Orchard instance with the greenhouse graft installed and an SSH key. Source: https://docs.orchard.hackclub.com/greenhouse/getting-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. ## Prerequisites - An Orchard instance with the [`greenhouse` graft installed](/operate/greenhouse/#install-the-graft). If **Greenhouse** is not in the dashboard sidebar, refer to [Troubleshooting Greenhouse](/greenhouse/troubleshooting/#greenhouse-is-not-in-the-sidebar). - Membership in an [organization](/teams/organizations/). 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](/cli/), if you use the CLI steps. ## 1. Add an SSH key Orchard requires [an SSH key](/account/ssh-identities/) to create a machine. Editors and `ssh` use the key to connect. **Dashboard** 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. **CLI** Run the following command. It generates a key, registers it on your account, and configures `ssh`. ```bash orchard sandbox ssh-config --install ``` ## 2. Add an agent credential 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: ```bash claude setup-token ``` Store the token in Orchard: **Dashboard** 1. Go to **Account settings** > **Greenhouse**. 2. Under **Agent credentials**, paste the token into the **Claude Code** field. 3. Select **Save**. **CLI** Run the following command, paste the token, and press `CTRL + D`. ```bash orchard sandbox credentials set --claude - ``` 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**. ## 3. Create a machine **Dashboard** 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**. **CLI** ```bash orchard sandbox create my-machine --repo https://github.com/acme/app --wait ``` `--wait` returns when the machine is ready. `--runner` selects a runner. The instance default applies if you omit it. 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](/operate/greenhouse/#control-who-can-use-greenhouse). The default limit is one machine. ## 4. Start a session **Dashboard** 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`. **CLI** ```bash orchard sandbox session create my-machine app --prompt "Fix the flaky login test" ``` `--base` selects a base branch. The repository's default branch applies if you omit it. Greenhouse creates a git worktree on a new branch named `orchard/` 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. ## Next steps - [Review the agent's work and leave comments on its diff](/greenhouse/workspace/) - [Install dependencies in each new worktree](/greenhouse/scripts/) - [Open a pull request from the session](/greenhouse/pull-requests/) ## Related resources - [Machines](/greenhouse/machines/) - Learn what each runner provides, what persists across a stop, and which limits apply. - [Connect an editor over SSH](/greenhouse/editors/) - Open a session in VS Code, Cursor, or Zed. - [Share a machine](/greenhouse/sharing/) - Invite people from your organization to work on the machine with you.