Skip to main content
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.
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.

​
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
1

Clone the repository

Open Terminal and run the following command to download Orchard to your machine:
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.
2

Enter the directory

Navigate into the cloned repository:
cd orchard
All subsequent commands run from this directory.
3

Run provisioning

Start the provisioning script:
./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.
4

Verify the installation (optional)

If you want to confirm everything is working correctly after provisioning, run the test suite manually:
./test.sh
The tests check that Orchard’s install steps completed as expected. A passing run means your machine is fully provisioned.
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.

​
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. To understand every preference Orchard sets, see system preferences.