Add homebrew as installation option

Fixes #10874

docs/static/getting-started-with-logstash.asciidoc

@@ -45,8 +45,13 @@ error message, and Logstash will be unable to start properly.
 [[installing-binary]]
 === Installing from a Downloaded Binary
 
-Download the https://www.elastic.co/downloads/logstash[Logstash installation file] that matches your host environment.
-Unpack the file. Do not install Logstash into a directory path that contains colon (:) characters.
+The {ls} binaries are available from 
+https://www.elastic.co/downloads/logstash[https://www.elastic.co/downloads].
+Download the Logstash installation file for your host environment--TARG.GZ, DEB,
+ZIP, or RPM. 
+
+Unpack the file. Do not install Logstash into a directory path that
+contains colon (:) characters.
 
 [NOTE]
 --
@@ -230,6 +235,51 @@ See the {logstash-ref}/running-logstash.html[Running Logstash] document for mana
 
 endif::[]
 
+[float]
+[[brew]]
+=== Installing {ls} on macOS with Homebrew
+
+Elastic publishes Homebrew formulae so you can install {ls} with the
+https://brew.sh/[Homebrew] package manager.
+
+To install with Homebrew, you first need to tap the Elastic Homebrew repository:
+
+[source,sh]
+-------------------------
+brew tap elastic/tap
+-------------------------
+
+After you've tapped the Elastic Homebrew repo, you can use `brew install` to
+install the default distribution of {ls}:
+
+[source,sh]
+-------------------------
+brew install elastic/tap/logstash-full
+-------------------------
+
+This installs the most recently released default distribution of {ls}.
+To install the OSS distribution, specify `elastic/tap/logstash-oss`.
+
+
+[float]
+[[brew-start]]
+==== Starting {ls} with Homebrew
+
+To have launchd start elastic/tap/logstash-full now and restart at login, run:
+
+[source,sh]
+-----
+brew services start elastic/tap/logstash-full
+-----
+
+To run {ls}, in the foreground, run:
+
+[source,sh]
+-----
+logstash
+-----
+
+
 ==== Docker
 
 Images are available for running Logstash as a Docker container. They are