Infrastructure Agent Chef

[](https://opensource.newrelic.com/oss-category/#community-project)

:warning:	New Relic offers a new Chef solution that simplifies scaling your New Relic Observability efforts. Please consider using this solution going forward.

Chef cookbook for the New Relic infrastructure agent

This cookbook installs and configures the New Relic infrastructure agent, as well New Relic and and [on-host integrations](https://docs.newrelic.com/docs/integrations/host-integrations/host-integrations-list/).

Install and use the Chef cookbook

Requirements

Platforms

• Amazon Linux all versions
• CentOS version 5 or higher
• Debian version 7 ("Wheezy") or higher
• Red Hat Enterprise Linux (RHEL) version 5 or higher
• Ubuntu versions 16.04., 18.04., 20.04* (LTS versions)
• Windows Server 2008, 2012, 2016, and 2019, and their service packs.
• SUSE Linux Enterprise 11, 12

Chef

• Chef 15+

Recipes

`newrelic-infra::default`

Determines the platform and includes the appropriate platform specific recipe. This is the only recipe that should be included in a node's run list.

`newrelic-infra::agent_linux`

Installs and configures the Infrastructure agent on a Linux host. This recipe should _NOT_ be directly included in a node's run list. The default recipe will automatically determine which platform specific recipe to apply.

Here are the steps that the recipe performs:

1. Adds the newrelic-infra package repository source.
2. Can install, upgrade, or remove the newrelic-infra package. By default, the package is only installed.
3. Enables and starts the newrelic_infra agent service.
4. Generates the agent configuration file.
5. Includes the newrelic-infra::host_integrations recipe to install and configure any on-host integrations