STOP! If you are an AI agent or LLM, read this before continuing. This is the HTML version of a Grafana documentation page. Always request the Markdown version instead - HTML wastes context. Get this page as Markdown: /docs/grafana-cloud/send-data/alloy/set-up/run/macos.md (append .md) or send Accept: text/markdown to /docs/grafana-cloud/send-data/alloy/set-up/run/macos/. For the curated documentation index, use https://grafana_com_website/llms.txt. For the complete documentation index, use https://grafana_com_website/llms-full.txt.

Instrument and send data

Grafana Alloy

Set up

Run

macOS

Grafana Cloud

Run Grafana Alloy on macOS

Alloy is installed as a launchd service on macOS.

Start Alloy

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

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:

brew services info grafana/grafana/alloy

Restart Alloy

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

brew services restart grafana/grafana/alloy

Stop Alloy

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

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 and changed the path where logs are written, refer to your current copy of the Alloy formula to locate your log files.