Documentation for automated readers
A curated documentation index is available at: https://grafana.com/llms.txt
A complete documentation index is available at: https://grafana.com/llms-full.txt
These indexes can help with page discovery before fetching individual documents.
This page is also available in Markdown, which may be easier for automated readers and AI tools to parse than HTML. The Markdown version is available at https://grafana.com/docs/alloy/next/set-up/run/macos.md, or by sending Accept: text/markdown to https://grafana.com/docs/alloy/next/set-up/run/macos/. For broader documentation discovery, the curated index is available at https://grafana.com/llms.txt and the complete index is available at https://grafana.com/llms-full.txt.
This is documentation for the next version of Grafana Alloy Documentation. For the latest stable release, go to the latest version.
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/alloyAlloy 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/alloyRestart Alloy
To restart Alloy, run the following command in a terminal window:
brew services restart grafana/grafana/alloyStop Alloy
To stop Alloy, run the following command in a terminal window:
brew services stop grafana/grafana/alloyView 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.
Next steps
Was this page helpful?
Related resources from Grafana Labs


