Tarball assisted install of the infrastructure agent for Linux

With the assisted install of the infrastructure agent for Linux, you can make the changes you need to the installation script and configuration file we provide so you can adapt it to your environment.

Assisted install only works for the Systemd, Upstart, and SysV service managers. If you use any other service manager, proceed with the manual install.

Before installation, check the compatibility and requirements.

Install the agent

To install the agent:

  1. Download the packaged agent file.
  2. Unpack the file.
  3. Make sure the file unpacks with the following structure:
    |-- config_defaults.sh
    |-- etc
    |   |-- init_scripts
    |   |   |-- systemd
    |   |   |   `-- newrelic-infra.service
    |   |   |-- sysv
    |   |   |   `-- newrelic-infra
    |   |   `-- upstart
    |   |       `-- newrelic-infra
    |   `-- newrelic-infra
    |       `-- integrations.d
    |-- installer.sh
    |-- usr
    |   `-- bin
    |       |-- newrelic-infra
    |       |-- newrelic-infra-ctl
    |       `-- newrelic-infra-service
    `-- var
        |-- db
        |   `-- newrelic-infra
        |       |-- custom-integrations
        |       |-- integrations.d
        |       |-- LICENSE.txt
        |       `-- newrelic-integrations
        |-- log
        |   `-- newrelic-infra
        `-- run
            `-- newrelic-infra
  4. Update your license key in config_defaults.sh.
  5. Optional: Update any other environment parameters in the configuration file.
  6. Execute installer.sh with admin rights.

The script automatically identifies your service manager. If it fails, it will prompt you to manually update it.

As of version 1.4.0, the infrastructure agent package includes the additional newrelic-infra-ctl binary, which is used to help troubleshoot a running agent. Although this binary is not required to execute the agent, we recommend to add it in your path. See our docs for more information.

Configure your installation

The configuration file config_defaults.sh serves as a source of reference for all the configuration options. It contains the following environment parameters:

Variable Description


Required at agent startup.

The agent home directory.




Required at installation.

The path to the agent binary folder.




Required at installation.

The agent configuration file's location.




Only configuration option required at startup.

The infrastructure agent license key.


Required at agent startup.

The location where the agent will log.




Required at installation.

The privilege level for the agent. Possible values are ROOT, PRIVILEGED or UNPRIVILEGED. For more info see our documentation on agent running modes.




Required at agent startup.

The location where the agent will place its PID file.




Required at agent startup.

The directory containing the configuration files of the integrations.




Required at installation time only when the running mode is set to either PRIVILEGED or UNPRIVILEGED.

The user that will run the agent binary.

What's next?

You may also want to:

For more help

If you need more help, check out these support and learning resources: