---
title: "Run Grafana Alloy on macOS | Grafana Cloud documentation"
description: "Learn how to run Grafana Alloy on macOS"
---

# Run Grafana Alloy on macOS

Alloy is [installed](/docs/grafana-cloud/send-data/alloy/set-up/install/macos) as a launchd service on macOS.

## Start Alloy

To start Alloy, run the following command in a terminal window:

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

```shell
brew services start grafana/grafana/alloy
```

Alloy automatically runs when the system starts.

Optional: To verify that the service is running, run the following command in a terminal window:

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

```shell
brew services info grafana/grafana/alloy
```

## Restart Alloy

To restart Alloy, run the following command in a terminal window:

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

```shell
brew services restart grafana/grafana/alloy
```

## Stop Alloy

To stop Alloy, run the following command in a terminal window:

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

```shell
brew services stop grafana/grafana/alloy
```

## View Alloy logs

By default, logs are written to `$(brew --prefix)/var/log/alloy.log` and `$(brew --prefix)/var/log/alloy.err.log`.

If you followed [Configure the Alloy service](/docs/grafana-cloud/send-data/alloy/configure/macos/#configure-the-alloy-service) and changed the path where logs are written, refer to your current copy of the Alloy formula to locate your log files.

## Next steps

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