From 19204f1df83228bdaea85df0baa51f096634e43e Mon Sep 17 00:00:00 2001
From: J Stickler <julie.stickler@grafana.com>
Date: Fri, 11 Oct 2024 16:18:29 -0400
Subject: [PATCH] docs: Update Promtail installation (#14473)

(cherry picked from commit 327ed29f9786c11a0bac662f0e480d72b6673fb0)
---
 .../send-data/promtail/installation.md        | 34 +++++++++++++++++++
 1 file changed, 34 insertions(+)

diff --git a/docs/sources/send-data/promtail/installation.md b/docs/sources/send-data/promtail/installation.md
index 25a818458a80d..38788091ec65d 100644
--- a/docs/sources/send-data/promtail/installation.md
+++ b/docs/sources/send-data/promtail/installation.md
@@ -41,6 +41,40 @@ See the instructions [here](https://grafana.com/docs/loki/<LOKI_VERSION>/setup/i
     docker run -v <local-path>:/mnt/config -v /var/log:/var/log --link loki grafana/promtail:3.0.0 --config.file=/mnt/config/promtail-config.yaml
     ```
 
+## Install on MacOS with Homebrew
+
+1. If necessary, install [Homebrew](https://brew.sh/).
+
+    ```bash
+    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+    ```
+
+1. Update Homebrew.
+
+    ```bash
+    brew update
+    ```
+
+1. Navigate to the [homebrew page for Promtail](https://formulae.brew.sh/formula/promtail).
+1. To install Promtail, run the following command:
+
+    ```bash
+    brew install promtail
+    ```
+
+1. Check that installation was successful.
+   1. Check that promtail exists in its install directory.
+
+      ```bash
+      which promtail
+      ```
+
+   1. Run promtail
+
+      ```bash
+      promtail
+      ```
+
 ## Install using Helm
 
 1. Make sure that Helm is installed. See [Installing Helm](https://helm.sh/docs/intro/install/).