NinjaOne Agent Installation: Add Device (Linux)

Topic

This guide provides instructions for generating a NinjaOne agent installer for a Linux device. Refer to our Mass Deployment of NinjaOne Installer.

Environment

NinjaOne Agent
Linux OS

Description

The NinjaOne agent installer is an executable file that installs the NinjaOne agent on a device, enabling it to be monitored and managed in NinjaOne. This guide explains how to generate the installer from the Ninja console, download it to your device, and share an installer link with end users.

How to Add a Computer to NinjaOne (NinjaOne, Inc., 00:01:26)

Before You Start

Before generating the installer, confirm that your environment meets the following requirements:

You must generate and install the NinjaOne agent on a device before you can manage it in NinjaOne.
To generate the NinjaOne Installer, you first need to set up an organization and create a policy. Refer to NinjaOne Endpoint Management: Creating and Editing Organizations and NinjaOne Policies: Create and Manage a Policy for instructions.

Generating a NinjaOne Installer

In NinjaOne, click the Add icon and choose Device from the drop-down menu.
Figure 1: Add → Device (click to enlarge)
Select Computer from the menu.
The Add a computer window opens. Select Linux and designate the Organization, Location, Device Role, Distribution type, and Architecture to which this device belongs. When finished, click Generate Installer.
NinjaOne displays a prompt alerting you that the installer has been generated successfully.

Sharing a Link to the Installer

Click Download to save the installer to your device, or click Copy link to copy a shareable installer link to your clipboard. This link may expire in the following circumstances:

Division cached installers are cleared.
A minor or major agent upgrade is released.
A bug fix for an installer-related issue has been released.

Do not use URL shorteners with NinjaOne installation links. Shortened links obscure the original URL, increasing the risk of input errors, and can be used by unintended parties to install the NinjaOne agent on unknown devices in your organization.

Installing the Linux Agent on a Device

You must run the installer on the command line for Linux machines. The following instructions work for RPM Package Manager or Debian/Ubuntu.

RPM Package Manager Instructions

Use this procedure for the following distributions:

Red Hat Enterprise Linux (RHEL)
Fedora
CentOS

Install NinjaOne Directly From the Generated Link

Open a terminal and type the following command, replacing <rpm package link> with the installer link generated by NinjaOne.

wget -O ninjarmm-agent.rpm <rpm package link>

Run the following commands, replacing <rpm package name> with the rpm package name. If the install succeeds, the directory lists NinjaOne program files, such as ninjarmm-linagent.

sudo rpm -i ninjarmm-agent.rpm

ls /opt/NinjaRMMAgent/programfiles

Verify the installation by running the following command. Your device should return an output of Active.

sudo systemctl status ninjarmm-agent.service

Install NinjaOne from a Downloaded Copy of the Installer

Open a terminal and navigate to the directory folder in which the RPM package is saved, then type the following commands. If the install succeeds, the directory lists NinjaOne program files, such as ninjarmm-linagent.

sudo rpm -i <rpm package name>

ls /opt/NinjaRMMAgent/programfiles

Verify the installation by running the following command. Your device should return an output of Active.

sudo systemctl status ninjarmm-agent.service

Debian Package Manager Instructions