---
title: "Install Grafana Agent Flow with Chef | Grafana Agent documentation"
description: "Learn how to install Grafana Agent Flow with Chef"
---

# Install Grafana Agent Flow with Chef

You can use Chef to install and manage Grafana Agent Flow.

## Before you begin

- These steps assume you already have a working [Chef](https://www.chef.io/products/chef-infrastructure-management/) setup.
- You can add the following resources to any new or existing recipe.
- These tasks install Grafana Agent Flow from the package repositories. The tasks target Linux systems from the following families:
  
  - Debian (including Ubuntu)
  - RedHat Enterprise Linux
  - Amazon Linux
  - Fedora

## Steps

To add Grafana Agent Flow to a host:

1. Add the following resources to your [Chef](https://www.chef.io/products/chef-infrastructure-management/) recipe to add the Grafana package repositories to your system:
   
   ruby ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
   
   ```ruby
   if platform_family?('debian', 'rhel', 'amazon', 'fedora')
     if platform_family?('debian')
       remote_file '/etc/apt/keyrings/grafana.gpg' do
         source 'https://apt.grafana.com/gpg.key'
         mode '0644'
         action :create
         end
   
       file '/etc/apt/sources.list.d/grafana.list' do
         content "deb [signed-by=/etc/apt/keyrings/grafana.gpg] https://apt.grafana.com/ stable main"
         mode '0644'
         notifies :update, 'apt_update[update apt cache]', :immediately
       end
   
       apt_update 'update apt cache' do
         action :nothing
       end
     elsif platform_family?('rhel', 'amazon', 'fedora')
       yum_repository 'grafana' do
         description 'grafana'
         baseurl 'https://rpm.grafana.com/oss/rpm'
         gpgcheck true
         gpgkey 'https://rpm.grafana.com/gpg.key'
         enabled true
         action :create
         notifies :run, 'execute[add-rhel-key]', :immediately
       end
   
       execute 'add-rhel-key' do
         command "rpm --import https://rpm.grafana.com/gpg.key"
         action :nothing
       end
     end
   else
       fail "The #{node['platform_family']} platform is not supported."
   end
   ```
2. Add the following resources to install and enable the `grafana-agent-flow` service:
   
   ruby ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
   
   ```ruby
   package 'grafana-agent-flow' do
     action :install
     flush_cache [ :before ] if platform_family?('amazon', 'rhel', 'fedora')
     notifies :restart, 'service[grafana-agent-flow]', :delayed
   end
   
   service 'grafana-agent-flow' do
     service_name 'grafana-agent-flow'
     action [:enable, :start]
   end
   ```

## Configuration

The `grafana-agent-flow` package installs a default configuration file that doesn’t send telemetry anywhere.

The default configuration file location is `/etc/grafana-agent-flow.river`. You can replace this file with your own configuration or create a new configuration file for the service to use.

## Next steps

- [Configure Grafana Agent Flow](/docs/agent/v0.43/flow/tasks/configure/configure-linux/)