--- title: Tarball assisted install of the infrastructure agent for Linux source: https://docs.newrelic.com/docs/infrastructure/infrastructure-agent/linux-installation/tarball-assisted-linux --- With the assisted install of the [infrastructure](https://docs.newrelic.com/docs/infrastructure/new-relic-infrastructure/get-started/introduction-new-relic-infrastructure) agent for Linux, you can make the changes you need to the installation script and [configuration file](#parameters) we provide so you can adapt it to your environment. > #### ⚠️ IMPORTANT > > Assisted install only works for the Systemd, Upstart, and SysV service managers. If you use any other service manager, proceed with the [manual install](https://docs.newrelic.com/docs/infrastructure/install-configure-infrastructure/linux-installation/manual-install-infrastructure-linux). Before installation, check the [compatibility and requirements](https://docs.newrelic.com/docs/infrastructure/install-infrastructure-agent/get-started/requirements-infrastructure-agent/). ## Install the agent [#install] To install the agent: 1. Download the [packaged agent file](https://download.newrelic.com/infrastructure_agent/binaries/linux/) or use the following command that automatically fetches a specific version of the agent, its checksum and verifies it after download. Replace `ARCH=amd64` with desired architecture (amd64, 386, arm64, arm) and `V=1.27.4` with [latest or specific version](https://github.com/newrelic/infrastructure-agent/releases/latest). ```shell V=1.27.4 ARCH=amd64; echo "https://download.newrelic.com/infrastructure_agent/binaries/linux/${ARCH}/newrelic-infra_linux_${V}_${ARCH}.tar.gz" | { read url; wget "${url}"{,.sum}; shasum -a 256 --check ${url##*/}.sum; } ``` From version `1.27.4` on, we provide the `tar.gz` package GPG signature. You can check the signature procedure and instructions for verification in the [infra-agent repository on GitHub](https://github.com/newrelic/infrastructure-agent/blob/master/docs/pgp-signed-release.md). 2. Unpack the file. 3. Make sure the file unpacks with the following structure: ``` newrelic-infra |-- 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](#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. ## Configure your installation [#parameters] 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 | | --------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `NRIA_AGENT_DIR` Required at agent startup. | The agent home directory. Default: ```` /var/db/newrelic-infra/ ``` ```` | | `NRIA_BIN_DIR` Required at installation. | The path to the agent binary folder. Default: ```` /usr/local/bin ``` ```` | | `NRIA_CONFIG_FILE` Required at installation. | The agent configuration file's location. Default: ```` /etc/newrelic-infra.yml ``` ```` | | `NRIA_LICENSE_KEY` Only configuration option required at startup. | The infrastructure agent license key. | | `NRIA_LOG_FILE` Required at agent startup. | The location where the agent will log. Default: ```` /var/run/newrelic-infra/newrelic-infra.log ``` ```` | | `NRIA_MODE` 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](https://docs.newrelic.com/docs/infrastructure/install-infrastructure-agent/linux-installation/linux-agent-running-modes/#set-mode). Default: ```` ROOT ``` ```` | | `NRIA_PID_FILE` Required at agent startup. | The location where the agent will place its PID file. Default: ```` /var/run/newrelic-infra/newrelic-infra.pid ``` ```` | | `NRIA_PLUGIN_DIR` Required at agent startup. | The directory containing the configuration files of the integrations. Default: ```` /etc/newrelic-infra/integrations.d/ ``` ```` | | `NRIA_USER` 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? [#what-next] You may also want to: - [Add custom attributes](https://docs.newrelic.com/docs/infrastructure-configure-your-agent#conf-custom_attributes) to annotate your infrastructure data. - [Connect your AWS account](https://docs.newrelic.com/docs/infrastructure-amazon-aws-ec2-integration#connect) if your servers are hosted on Amazon EC2. - Enable [log forwarding](https://docs.newrelic.com/docs/logs/forward-logs/forward-your-logs-using-infrastructure-agent#tarball-install). - Add other [infrastructure integrations](https://docs.newrelic.com/docs/infrastructure/introduction-infra-monitoring) to collect data from external services. - Manually [start, stop, restart, or check the agent status](https://docs.newrelic.com/docs/infrastructure-start-stop-restart-check-agent-status#linux).