---
title: "Install Grafana Agent in static mode on macOS | Grafana Agent documentation"
description: "Learn how to install Grafana Agent in static mode on macOS"
---

# Install Grafana Agent in static mode on macOS

You can install Grafana Agent in static mode on macOS with Homebrew.

## Before you begin

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

> 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`.

## Install

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

1. Update Homebrew:
   
   shell ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
   
   ```shell
   brew update
   ```
2. Install Grafana Agent:
   
   shell ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
   
   ```shell
   brew install grafana-agent
   ```

Grafana Agent is installed by default at `$(brew --prefix)/Cellar/grafana-agent/VERSION`.

## Upgrade

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

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

## Uninstall

To uninstall Grafana Agent 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-agent
```

## Configure

1. To create the Agent `config.yml` file, open a terminal and run the following command:
   
   shell ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
   
   ```shell
   touch $(brew --prefix)/etc/grafana-agent/config.yml
   ```
2. Edit `$(brew --prefix)/etc/grafana-agent/config.yml` and add the configuration blocks for your specific telemetry needs. Refer to [Configure Grafana Agent](/docs/agent/v0.43/static/configuration/create-config-file/) for more information.

> Note
> 
> To send your data to Grafana Cloud, set up Grafana Agent using the Grafana Cloud integration. Refer to [how to install an integration](/docs/grafana-cloud/data-configuration/integrations/install-and-manage-integrations/) and [macOS integration](/docs/grafana-cloud/data-configuration/integrations/integration-reference/integration-macos-node/).

## Next steps

- [Start Grafana Agent](/docs/agent/v0.43/static/set-up/start-agent/)
- [Configure Grafana Agent](/docs/agent/v0.43/static/configuration/create-config-file/)