diff --git a/guides/cli/how-to-install-the-lightdash-cli.mdx b/guides/cli/how-to-install-the-lightdash-cli.mdx
index 966ff888..d9ba931d 100644
--- a/guides/cli/how-to-install-the-lightdash-cli.mdx
+++ b/guides/cli/how-to-install-the-lightdash-cli.mdx
@@ -86,25 +86,41 @@ You can also download the CLI binary directly from [GitHub releases](https://git
 
 ### Update to the latest version
 
-To update your Lightdash CLI to the latest version, run:
-
-```bash
-npm update -g @lightdash/cli
-```
+To update your Lightdash CLI to the latest version, run one of the following depending on how you installed it:
+
+<Tabs>
+  <Tab title="Homebrew">
+    ```bash
+    brew upgrade lightdash
+    ```
+  </Tab>
+  <Tab title="npm">
+    ```bash
+    npm update -g @lightdash/cli
+    ```
+  </Tab>
+</Tabs>
 
 ### Update to a specific version
 
-To update (or downgrade) to a specific version of the Lightdash CLI, run:
+<Tabs>
+  <Tab title="Homebrew">
+    Homebrew doesn't support installing specific versions directly. To install a specific version, use npm instead or download the binary from [GitHub releases](https://github.com/lightdash/lightdash/releases).
+  </Tab>
+  <Tab title="npm">
+    To update (or downgrade) to a specific version of the Lightdash CLI, run:
 
-```bash
-npm install -g @lightdash/cli@VERSION_NUMBER
-```
+    ```bash
+    npm install -g @lightdash/cli@VERSION_NUMBER
+    ```
 
-Replace `VERSION_NUMBER` with the desired version. For example:
+    Replace `VERSION_NUMBER` with the desired version. For example:
 
-```bash
-npm install -g @lightdash/cli@0.1743.1
-```
+    ```bash
+    npm install -g @lightdash/cli@0.1743.1
+    ```
+  </Tab>
+</Tabs>
 
 <Info>
   You can check your current CLI version by running `lightdash --version`.
diff --git a/references/lightdash-cli.mdx b/references/lightdash-cli.mdx
index 7a3a91b0..ebae015e 100644
--- a/references/lightdash-cli.mdx
+++ b/references/lightdash-cli.mdx
@@ -41,12 +41,22 @@ Ignores the preceding command and shows the installed CLI version. Usually it's
 lightdash --version
 ```
 
-If you need to upgrade your version of the Lightdash cli, run the following in your terminal:
+If you need to upgrade your version of the Lightdash CLI, run one of the following in your terminal depending on how you installed it:
 
-```bash
-npm install -g @lightdash/cli
-lightdash --version
-```
+<Tabs>
+  <Tab title="npm">
+    ```bash
+    npm install -g @lightdash/cli
+    lightdash --version
+    ```
+  </Tab>
+  <Tab title="Homebrew">
+    ```bash
+    brew upgrade lightdash
+    lightdash --version
+    ```
+  </Tab>
+</Tabs>
 
 ### Help