Already a NinjaOne customer? Log in to view more guides and the latest updates.

Fix Installation Error 2503 or 2502

Issue

When attempting to install the NinjaOne agent or NinjaOne NMS agent, the installation fails with error 2503 or 2502.

Environment

NinjaOne RMM agent

Cause

This error is generally caused by a permissions-related issue with the folder from which the file is being executed or the package itself.

Resolution

Incorrect or broken file permissions can cause problems when attempting to run any installer, and the installer packages for NinjaOne are no exception. Correcting the permissions issues with the folder would be ideal, but due to the varying state of customer environments, it is difficult to pinpoint the exact location of the failure. 

The following instructions are intended to work around this problem in order to successfully install NinjaOne-related installer packages.

In order to successfully install the package, it must be launched with administrative privileges from outside Windows Explorer. The easiest way to achieve this is via the command prompt: 

  1. Launch the command prompt with "Run as administrator" privileges.
  2. Change the directory to the folder where the installer is currently located.
  3. Launch the MSI package from within the command prompt.

This should launch the installer, bypassing the permissions-related problems with Explorer, and successfully install the package.

Additional Resources

The following learning content will help you fully utilize the NinjaOne agent. 

NinjaOne Agent: Resource Catalog

FAQ

Next Steps