install-from-github.md

title	toc	weight	docs
Install from GitHub package files	true	300	DOCS-000

{{< note>}} If you are using [NGINX One Console]({{< ref "/nginx-one/getting-started.md" >}}) to manage your NGINX instances, NGINX Agent is installed automatically when you add an NGINX instance to NGINX One Console.

For a quick guide on how to connect your instance to NGINX One Console see: [Connect to NGINX One Console]({{< relref "/nginx-one/how-to/nginx-configs/add-instance" >}}) {{< /note >}}

Follow the steps in this guide to install NGINX Agent in your NGINX instance using GitHub package files.

Before you begin

{{< include "/agent/installation/prerequisites.md" >}}

GitHub package files

To install NGINX Agent on your system using GitHub package files, go to the GitHub releases page and download the latest package supported by your operating system distribution and CPU architecture.

Use your system's package manager to install the package. Some examples:

• Debian, Ubuntu, and other distributions using the dpkg package manager.

  sudo dpkg -i nginx-agent-<agent-version>.deb

• RHEL, CentOS RHEL, Amazon Linux, Oracle Linux, and other distributions using the yum package manager

  sudo yum localinstall nginx-agent-<agent-version>.rpm

• RHEL and other distributions using the rpm package manager

  sudo rpm -i nginx-agent-<agent-version>.rpm

• Alpine Linux

  sudo apk add nginx-agent-<agent-version>.apk

• FreeBSD

  sudo pkg add nginx-agent-<agent-version>.pkg

Manually connect NGINX Agent to NGINX One Console

{{< include "agent/installation/manually-connect-to-console" >}}

Start, stop, and enable NGINX Agent

{{< include "/agent/installation/start-stop-agent.md" >}}

Verify that NGINX Agent is running

{{< include "/agent/installation/verify-agent.md" >}}