---
title: "Install Grafana Alloy on macOS | Grafana Cloud documentation"
description: "Learn how to install Grafana Alloy on macOS"
---

# Install Grafana Alloy on macOS

Start your learning experience with Grafana Learning Paths

Grafana Learning Paths provide a clear, structured path that leads you from beginner concepts to advanced use cases. Learn about this Grafana feature on [Monitor a macOS system in Grafana Cloud](/docs/learning-journeys/macos-integration/).

[Start learning](https://grafana.com/docs/learning-journeys/macos-integration/)

You can install Alloy on macOS with Homebrew.

> Note
> 
> The default prefix for Homebrew on Intel is `/usr/local`. The default prefix for Homebrew on Apple Silicon is `/opt/Homebrew`.
> 
> To verify the default prefix for Homebrew on your computer, open a terminal window and type `brew --prefix`.

## Before you begin

- Install [Homebrew](https://brew.sh) on your computer.

## Install

To install Alloy on macOS, run the following commands in a terminal window.

1. Add the Grafana Homebrew tap:
   
   shell ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
   
   ```shell
   brew tap grafana/grafana
   ```
2. Install Alloy:
   
   shell ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
   
   ```shell
   brew install grafana/grafana/alloy
   ```

## Upgrade

To upgrade Alloy on macOS, run the following commands in a terminal window.

1. Upgrade Alloy:
   
   shell ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
   
   ```shell
   brew upgrade grafana/grafana/alloy
   ```
2. Restart Alloy:
   
   shell ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
   
   ```shell
   brew services restart grafana/grafana/alloy
   ```

## Uninstall

To uninstall Alloy on macOS, run the following command in a terminal window:

shell ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy

```shell
brew uninstall grafana/grafana/alloy
```

## Next steps

- [Run Alloy](/docs/grafana-cloud/send-data/alloy/set-up/run/macos)
- [Configure Alloy](/docs/grafana-cloud/send-data/alloy/configure/macos)