Upload user-defined scripts

Watch the video

If you need to monitor products, track indicators, or schedule maintenance tasks that aren’t included in N-sight RMM by default, you can upload user-defined scripts to the Script Manager repository.

You can:

You can add user-defined scripts as:

  • Script Checks: Scripts that run as 24x7 or Daily Safety checks.
  • Automated Tasks: Scripts that run as maintenance tasks.

After you upload a script to the Script Manager repository, you can deploy it to devices to run checks or tasks.

Upload a script to the Script Manager repository

  1. In the All Devices view, go to Settings > Script Manager.
  2. Select New.
  3. Enter the script details in the Add User Defined Scripts dialog:

    • Name: A descriptive name to identify the script in the All Devices view and reports.
    • Description: The purpose of the script.
    • Usage Notes: Information shown in the Test Parameters section when you add or edit a Script Check or Automated Task. Include details about the script’s function or examples of command-line parameters to help users configure the script correctly.
    • Default Timeout: The time in seconds after which the Agent stops the script and reports it as failed.
    • Type: Choose whether the script runs as a Script Check or an Automated Task.

      Automated Tasks are supported for Windows, Mac (from Agent 2.3.0), and Linux (from Agent 2).

    • OS: The operating system the script is designed for. The script will only be available for devices running that OS.

      The Mac Agent and Linux Agent support Shell scripts and interpreted languages such as Perl, PHP, Python, Ruby for which there is a handler installed.

  4. Browse to the script location.
    • Maximum script size: 65,535 characters
    • Maximum script output size: 10,000 characters
  5. Select Save to upload the script.

Script guidelines

  • The Mac Agent and Linux Agent support shell scripts and interpreted languages such as Perl, PHP, Python, Ruby, provided the handler installed.
  • To help a shell script run successfully, declare the Bash interpreter at the beginning of the script: #!/bin/bash

    #!/bin/bash
    "Hello world"
    exit 0

You can run user-defined scripts, but N-able does not manage or validate them. N-able is not liable for system, hardware, or data loss. Customers or developers must confirm the integrity and impact of any custom scripts.

What do you want to do?