---
title: "Run Grafana Agent Flow on macOS | Grafana Agent documentation"
description: "Learn how to run Grafana Agent Flow on macOS"
---

# Run Grafana Agent Flow on macOS

Grafana Agent Flow is [installed](/docs/agent/latest/flow/get-started/install/macos/) as a launchd service on macOS.

## Start Grafana Agent Flow

To start Grafana Agent Flow, 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-agent-flow
```

Grafana Agent Flow 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-agent-flow
```

## Restart Grafana Agent Flow

To restart Grafana Agent Flow, 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-agent-flow
```

## Stop Grafana Agent Flow

To stop Grafana Agent Flow, 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-agent-flow
```

## View Grafana Agent Flow logs on macOS

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

If you followed [Configure the Grafana Agent Flow service](/docs/agent/latest/flow/tasks/configure/configure-macos/#configure-the-grafana-agent-flow-service) and changed the path where logs are written, refer to your current copy of the Grafana Agent Flow formula to locate your log files.

## Next steps

- [Configure Grafana Agent Flow](/docs/agent/latest/flow/tasks/configure/configure-macos/)