brew/docs/BrewTestBot.md

---
logo: /assets/img/brewtestbot.png
image: /assets/img/brewtestbot.png
redirect_from:
  - /Brew-Test-Bot
last_review_date: "2025-02-08"
---

# BrewTestBot

[`brew test-bot`](Manpage.md#test-bot-options-formula) is what runs the automated review and testing system funded by [our Kickstarter in 2013](https://www.kickstarter.com/projects/homebrew/brew-test-bot).

It comprises three Mac Pros hosting virtual machines, several Intel and M1 Mac minis and some cloud Ubuntu instances that run the [`test-bot.rb`](https://github.com/Homebrew/homebrew-test-bot) external command to perform bottle builds and automated testing of the full lifecycle of any change to Homebrew or its taps.

## Pull Requests

The bot automatically builds pull requests and updates their status depending on the result of the job.

For example, a job which has been queued but not yet completed will have a section in the pull request that looks like this:

![Triggered Pull Request](assets/img/docs/brew-test-bot-triggered-pr.png)

---

A failed build looks like this:

![Failed Pull Request](assets/img/docs/brew-test-bot-failed-pr.png)

---

A passed build that's been approved to merge looks like this:

![Passed Pull Request](assets/img/docs/brew-test-bot-passed-pr.png)

---

On failed or passed builds you can click the "Details" link for each check to view its output in GitHub Actions.
docs: add logos. Add the BrewTestBot and Linuxbrew logos to the relevant pages. 2019-03-23 12:56:05 +00:00			`---`
docs: use relative path for custom header images 2023-08-27 12:34:50 -04:00			`logo: /assets/img/brewtestbot.png`
			`image: /assets/img/brewtestbot.png`
docs: redirect from old BrewTestBot URLs Also, sweep up remaining "Brew Test Bot" instances, and use brewtestbot.png for both BrewTestBot pages. 2024-02-15 14:50:24 -05:00			`redirect_from:`
			`- /Brew-Test-Bot`
Review some docs - Most of these were fine still, apart from: - FAQ: `hub` is less maintained than `gh`. - Brew-Maintainer-Guide: link to GitHub docs on commit signing via GPG or SSH. - Interesting-Taps-and-Forks: remove outdated information about `homebrew/core` being in `Library/Taps`. - New-Maintainer-Checklist: remove outdated information about the `@members` team. 2025-02-08 14:21:38 +00:00			`last_review_date: "2025-02-08"`
docs: add logos. Add the BrewTestBot and Linuxbrew logos to the relevant pages. 2019-03-23 12:56:05 +00:00			`---`
docs: restore h1 headings for pages with front matter Plus other fixes for Homebrew-on-Linux.md. GitHub Pages' jekyll-titles-from-headings sets a page's title to its first Markdown heading. 2020-06-11 14:04:12 -04:00
docs: redirect from old BrewTestBot URLs Also, sweep up remaining "Brew Test Bot" instances, and use brewtestbot.png for both BrewTestBot pages. 2024-02-15 14:50:24 -05:00			`# BrewTestBot`
docs: restore h1 headings for pages with front matter Plus other fixes for Homebrew-on-Linux.md. GitHub Pages' jekyll-titles-from-headings sets a page's title to its first Markdown heading. 2020-06-11 14:04:12 -04:00
Docs: update test-bot images and description 2023-09-01 13:24:12 -04:00			[`brew test-bot`](Manpage.md#test-bot-options-formula) is what runs the automated review and testing system funded by [our Kickstarter in 2013](https://www.kickstarter.com/projects/homebrew/brew-test-bot).
Import docs from wiki. Closes Homebrew/homebrew#33211. 2014-10-26 14:54:36 +00:00
Docs: update test-bot images and description 2023-09-01 13:24:12 -04:00			It comprises three Mac Pros hosting virtual machines, several Intel and M1 Mac minis and some cloud Ubuntu instances that run the [`test-bot.rb`](https://github.com/Homebrew/homebrew-test-bot) external command to perform bottle builds and automated testing of the full lifecycle of any change to Homebrew or its taps.
Import docs from wiki. Closes Homebrew/homebrew#33211. 2014-10-26 14:54:36 +00:00
			`## Pull Requests`

Contributors docs: adjust line breaks 2022-04-19 21:28:17 -04:00			`The bot automatically builds pull requests and updates their status depending on the result of the job.`
Import docs from wiki. Closes Homebrew/homebrew#33211. 2014-10-26 14:54:36 +00:00
Contributors docs: adjust line breaks 2022-04-19 21:28:17 -04:00			`For example, a job which has been queued but not yet completed will have a section in the pull request that looks like this:`
Import docs from wiki. Closes Homebrew/homebrew#33211. 2014-10-26 14:54:36 +00:00
Use Homebrew’s Jekyll theme These means we can remove a bunch of the HTML from this repository and move it to https://github.com/homebrew/jekyll-theme-homebrew. 2018-05-02 17:57:32 +01:00			`![Triggered Pull Request](assets/img/docs/brew-test-bot-triggered-pr.png)`
Import docs from wiki. Closes Homebrew/homebrew#33211. 2014-10-26 14:54:36 +00:00
			`---`

			`A failed build looks like this:`

Use Homebrew’s Jekyll theme These means we can remove a bunch of the HTML from this repository and move it to https://github.com/homebrew/jekyll-theme-homebrew. 2018-05-02 17:57:32 +01:00			`![Failed Pull Request](assets/img/docs/brew-test-bot-failed-pr.png)`
Import docs from wiki. Closes Homebrew/homebrew#33211. 2014-10-26 14:54:36 +00:00
			`---`

Docs: update test-bot images and description 2023-09-01 13:24:12 -04:00			`A passed build that's been approved to merge looks like this:`
Import docs from wiki. Closes Homebrew/homebrew#33211. 2014-10-26 14:54:36 +00:00
Use Homebrew’s Jekyll theme These means we can remove a bunch of the HTML from this repository and move it to https://github.com/homebrew/jekyll-theme-homebrew. 2018-05-02 17:57:32 +01:00			`![Passed Pull Request](assets/img/docs/brew-test-bot-passed-pr.png)`
Import docs from wiki. Closes Homebrew/homebrew#33211. 2014-10-26 14:54:36 +00:00
			`---`

Docs: update test-bot images and description 2023-09-01 13:24:12 -04:00			`On failed or passed builds you can click the "Details" link for each check to view its output in GitHub Actions.`