Skip to content
Jared Nay edited this page Apr 22, 2022 · 4 revisions

To use recipes, you must add the repo that contains each recipe, plus any repos that contain its parent recipe(s). For security and ease of maintenance, we recommend adding only the repos you need.

Searching for recipes

  1. In the Repos & Recipes tab, enter the name of the app into the "Search for a recipe on GitHub" field, and click Search.

    Search for a Recipe

  2. From the list of results, select your desired recipe. If the repo is not already added (as shown by the green indicator), then click Add Repo.

    Add a Repo

    (Not sure which one to choose? Check out the Choosing the Best Recipe page.)

  3. Click Close to return to the recipe list.

  4. Filter the recipe list for the name of the app you just added.

  5. Right-click and Create Override on the recipe you wish to use.

  6. Check the box on the override to add it to your AutoPkg run schedule.

For more information about overrides, skip ahead to the Overrides and Trust Info section.

Also be sure to add any repos that contain parent recipes. For details, check out the Managing Parent Repos section.

What if I can't find a recipe for my app?

Don't see a recipe for an app you use? Use Recipe Robot or write one manually!

Query AutoPkg's search directories using defaults read com.github.autopkg RECIPE_SEARCH_DIRS and put your own, local recipe into one of these search directories.

Keep in mind there are a handful of AutoPkg recipe repositories that don't live in the AutoPkg organization on GitHub (and therefore don't appear in search results). (For example, facebook/Recipes-for-AutoPkg.)