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

# Get started with Orchard: provision your Mac in minutes

> Provision your macOS workstation from scratch — clone the repository, run one script, and let Orchard install apps and configure your system preferences.

Orchard provisions your macOS machine with a single script. The steps below take you from a fresh machine to a fully configured workstation. The whole process runs mostly unattended and typically takes several minutes, depending on your internet connection and how many packages need to download.

<Note>
  macOS may prompt you for your password or ask to grant permissions at several points during installation — for example, when Homebrew installs system components or when apps request accessibility access. Keep an eye on the terminal and respond when prompted.
</Note>

## Prerequisites

Before you begin, make sure you have:

* A Mac running macOS
* An active internet connection
* Git available in your terminal — if it isn't installed, macOS will prompt you to install the Command Line Developer Tools when you first run `git`

<Steps>
  <Step title="Clone the repository">
    Open Terminal and run the following command to download Orchard to your machine:

    ```bash theme={null}
    git clone https://github.com/andrewshawcare/orchard.git
    ```

    If Git is not yet installed, macOS will display a dialog offering to install the Command Line Developer Tools. Accept the prompt, wait for the installation to finish, then run the command again.
  </Step>

  <Step title="Enter the directory">
    Navigate into the cloned repository:

    ```bash theme={null}
    cd orchard
    ```

    All subsequent commands run from this directory.
  </Step>

  <Step title="Run provisioning">
    Start the provisioning script:

    ```bash theme={null}
    ./provision.sh
    ```

    This single command runs every install script in sequence. Orchard will:

    * Install Homebrew (if not already present)
    * Install Homebrew packages and cask applications
    * Install Claude Code
    * Configure the Dock, Finder, keyboard, mouse, trackpad, and security preferences
    * Run the test suite to verify everything completed successfully

    The script runs mostly unattended. You may need to enter your password or approve permission dialogs at certain points, so stay nearby during the first few minutes.
  </Step>

  <Step title="Verify the installation (optional)">
    If you want to confirm everything is working correctly after provisioning, run the test suite manually:

    ```bash theme={null}
    ./test.sh
    ```

    The tests check that Orchard's install steps completed as expected. A passing run means your machine is fully provisioned.

    <Tip>
      Provisioning already runs `test.sh` at the end automatically. You only need to run this step manually if you want to re-check after making changes.
    </Tip>
  </Step>
</Steps>

## What happens next

Once provisioning is complete, your machine has all applications installed, system preferences applied, and your Dock cleaned up. You're ready to start working.

To add more packages or adjust which apps get installed, see [adding packages](/customization/adding-packages). To understand every preference Orchard sets, see [system preferences](/installed/system-preferences).