Skip to main content

Deployment Scope

Before you deploy, decide how the agent maps endpoints to organizations. There are two modes. The install properties differ between them. For the full property table, see Download and verify.

Single-org (internal IT)​

All agents register directly under the token's organization.

  • Pass USEPARENTORG=1 to register under the token's organization and create no client organization.
  • CLIENTNAME is not used in this mode.

Use single-org when all endpoints belong to one organization, for example your own internal IT.

Client-orgs (MSP, multi-tenant)​

Each endpoint auto-creates or links a child organization under the token's organization, keyed by your client identifiers. You do not pre-create client organizations by hand.

  • Pass RMMCLIENTID and/or PSACLIENTID as the linking keys. The agent creates or links the matching child organization.
  • Use a distinct identifier per client so each client gets its own organization.

The client name is a display label​

The client name only labels the organization. The RMM and PSA IDs do the linking.

  • Without CLIENTNAME, a new client organization is named for the endpoint's AD domain when it is domain-joined, otherwise for its RMM ID, then its PSA ID.
  • The name is set when the organization is created. An organization that already exists keeps its name.
  • Set the name yourself with CLIENTNAME. Quote values that contain spaces.
  • Use a distinct value per client. Do not set one name across a whole fleet. To group agents, use the RMM or PSA IDs.

Changing RMM or PSA platforms​

If you migrate to a different RMM or PSA platform, pause agent rollouts, update the RMM and PSA client IDs stored on your existing client organizations to the new platform's identifiers, then resume deployment with the new RMMCLIENTID/PSACLIENTID values. This keeps new installations landing in the existing client organizations instead of creating duplicates. Already-enrolled devices are unaffected by the change: they keep their identity and organization, and only new installs use the new identifiers.