Skip to main content

Install Datto RMM Agent

Summary​

Installs the Datto RMM Agent on both Windows and Mac machines.

The Platform parameter and the company-level custom field Datto RMM Site ID should be configured to perform installation.

Sample Run​

Image1

Dependencies​

User Parameters​

NameExampleAccepted ValuesRequiredDefaultTypeDescription
Platformmerlot
  • Pinotage
  • Merlot
  • Concord
  • Vidal
  • Zinfandel
  • Syrah
YesIt is recommended to set the platform name of your Datto RMM account.FlagPlatform name of your Datto RMM Account.
The platform name is at the start of the URL; it will be Pinotage or Merlot (EMEA), Concord, Vidal, or Zinfandel (NA), or Syrah (APAC).

Image2

Custom Fields​

NameExampleLevelTypeRequiredDescription
Datto RMM Site ID6ef3f5aa-81b7-400c-a667-02075f98ba15CompanyTextYesThe Site ID of the target site in the Datto RMM portal that the agent will check into after installation.

Task Setup Path​

  • Tasks Path: AUTOMATION ➞ Tasks
  • Task Type: Script Editor

Task Creation​

Description​

  • Name: Install Datto RMM Agent
  • Description:
Installs the Datto RMM Agent on both Windows and Mac machines. 

The "Platform" parameter and the company-level custom field "Datto RMM Site ID" should be configured to perform installation.
  • Category: Application

Image3

Parameters​

Platform​

Parameter NameRequired FieldParameter TypeDefault ValueValue
PlatformEnabledText StringEnabledIt is recommended to set the platform name of your Datto RMM account.

Image4

The default value shown in the screenshot above is for demonstration purposes only. It is recommended to use the platform name of your Datto RMM account as the default value, which may differ from the example shown.

Image5

Script Editor​

Row 1: Set Pre-defined Variable ( @ImmyBotTenant@ = ImmyBot Tenant )​

  • Variable Name: SiteId
  • Type: Custom Field
  • Custom Field: Datto RMM Site ID
  • Continue on Failure: False
  • Operating System: MacOs, Windows

Image6

Row 2: PowerShell script​

  • Use Generative AI Assist for script creation: False
  • Expected time of script execution in seconds: 900
  • Continue on Failure: False
  • Run As: System
  • Operating System: Windows
  • PowerShell Script Editor:

PowerShell Script

Image7

Row 3: Bash script​

  • Use Generative AI Assist for script creation: False
  • Expected time of script execution in seconds: 900
  • Continue on Failure: False
  • Run As: System
  • Operating System: MacOs
  • Bash Script Editor:

Bash Script

Image8

Row 4: Script Log​

  • Script Log Message: %Output%
  • Continue on Failure: False
  • Operating System: MacOs, Windows

Image9

Completed Script​

Image10

Output​

  • Script Log

Changelog​

2026-02-28​

  • Initial version of the document