Skip to main content
All CollectionsSetup and ConfigurationAgents
MacOS Remote Worker Agents - Command Line Parameters

MacOS Remote Worker Agents - Command Line Parameters

Instructions on how to perform a mass deployment of MacOS NetBeez agents via command line parameters.

Panickos Neophytou avatar
Written by Panickos Neophytou
Updated this week

Introduction

The MacOS remote worker agent by NetBeez supports mass deployments via software management suites such as Intune. This guide reviews available parameters that can be used to enable or disable certain options, such as naming the agents as they appear on the NetBeez dashboard, enable auto-start, auto-update, etc.

After installation, all these options can be modified manually by right-clicking on the NetBeez tray icon app.

Available Parameters

Flag

Description

Possible Values and examples

--autosetup (optional)

Determines whether the “Automatic setup” or “Manual setup” radio button will be selected.

Default: 1

  • 1 - Automatic setup with secret key

  • 2 - Manual setup with ports and certificate

--secretkey (required)

The secret key for your account which can be found on your NetBeez dashboard by going to Settings -> About page.

Example:

  • --secretkey=caafc19ae7214fb5nb18111a21031cf0f423c599

--certsource (required when --autosetup=2)

Sets the “Certificate file” input field value.

Example:

  • --certsource="/Users/user_name/Documents/cert.pem"

--dashboardurl (required when --autosetup=2)

Sets the “Dashboard URL” input field value.

Example:

  • --dashboardurl="acme.netbeezcloud.net"

--port - (required when --autosetup=2)

Sets the “Port” input field value.

Example:

  • --port=20019

--secureport (required when --autosetup=2)

Sets the “Secure Port” input field value.

Example:

  • --secureport=20018

--websocketport (required when --autosetup=2)

Sets the “Websocket Port” input field value.

Example:

  • --websocketport=443

--agentname (optional)

Sets the “Agent name” input field value.

Default value: The name of the machine you are running the installer on.

Example:

  • --agentname="John-Laptop"

--uuid (optional)

Sets the “UUID” input field value.

Default value: a new random UUID will be generated
Example:

  • --uuid="A2A4E8E8-AB20-461B-A771-7372744F46DB"

--autoupdate (optional)

Sets the “Auto update” checkbox to on or off.

Default value: 1

  • --autoupdate= - the agent will NOT update automatically on a new release

  • --autoupdate=1 - the agent will update automatically when a new release is available

--startonboot (optional)

Sets the “Start on boot” checkbox to off or on.

Default value: 1

  • --startonboot="" - the agent doesn't start on boot (the user must start it manually)

  • --startonboot=1 - the agent starts on boot

--installgroup (optional)

Set the “Install for all users” or “Only current user” radio button will be selected.

Default value: 1

  • --installgroup=1 - the agent is installed for all users

  • --installgroup=2 - the agent is installed only for the current user

Did this answer your question?