> For the complete documentation index, see [llms.txt](https://docs.nexthink.com/platform/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nexthink.com/platform/user-guide/remote-actions/setting-up-and-managing-remote-actions.md).

# Setting up and managing Remote Actions

Configure the Remote Actions module and its content to ensure Remote Actions users can fully benefit from it without interruptions.

* Review the Remote Actions technical prerequisites outlined in the [#before-you-begin](#before-you-begin "mention") section on this page.
* Review [Key Remote Actions configuration concepts](#key-remote-actions-configuration-concepts).
* View and configure out-of-the-box remote actions.
  * See the auto-installed [system remote actions](#system-remote-actions) available after the module is enabled.
  * See the library remote actions available within dedicated [Library packs](/platform/library-packs.md).
* See guides on how to [create and configure remote actions](/platform/user-guide/remote-actions/setting-up-and-managing-remote-actions/creating-remote-actions.md).
* See how to [manage remote actions](/platform/user-guide/remote-actions/setting-up-and-managing-remote-actions/managing-remote-actions.md) configured in your Nexthink instance.

## Before you begin

Nexthink Administrators must complete the following technical prerequisites to ensure all required system components and settings are correctly in place.

{% stepper %}
{% step %}
**Validate Collector version and settings**

Ensure all employee devices have Collector deployed and running:

* **Execution policy** other than Default must be configured on the Collector, to ensure remote actions can run on the device.
* For running remote actions **as a service on Windows Server devices**, Collector version **24.5 or later** is required.
* Fur running remote actions with Campaigns, Collector version **23.5 or later** is required.

{% hint style="info" %}
For more information on execution policy options, refer to:

* [Installing Collector on Windows](/platform/configuring_nexthink/bringing-data-into-your-nexthink-instance/deploying-nexthink-in-non-vdi-environment/installing-collector/installing-collector-on-windows.md)
* [Installing Collector on macOS](/platform/configuring_nexthink/bringing-data-into-your-nexthink-instance/deploying-nexthink-in-non-vdi-environment/installing-collector/installing-collector-on-macos.md)
  {% endhint %}
  {% endstep %}

{% step %}
**Set permissions**

Nexthink Administrators should enable permissions to ensure the correct configuration and monitoring of Remote Actions.

{% hint style="info" %}
For detailed information about available permissions, View domain options and Data privacy granularity settings, see:

* [Roles > Remote Actions](/platform/user-guide/administration/account-management/roles.md#roles-remoteactions)
* [View domain > Remote Actions](/platform/user-guide/administration/account-management/roles/view-domain.md#remote-actions)
  {% endhint %}
  {% endstep %}
  {% endstepper %}

***

## Key Remote actions configuration concepts

### Configuring remote actions for each use case

How you use remote actions depends on your purpose and your chosen trigger method. Nexthink has identified four main scenarios or use cases:

#### Assisted service <a href="#gettingstartedwithremoteactions-assistedservice" id="gettingstartedwithremoteactions-assistedservice"></a>

Use remote actions to help support teams assist employees.

* Set a **manual** [triggering mechanism](/platform/user-guide/remote-actions/setting-up-and-managing-remote-actions/creating-remote-actions.md#triggering) to allow support agents to execute remote actions from Investigations, Device View, or Amplify.
* Optionally, associate your remote action with a specific property or metric within a [checklist](/platform/user-guide/administration/content-management/checklists-management.md#adding-property-details-and-associated-actions) available from Device View or Amplify.

#### Self-help <a href="#gettingstartedwithremoteactions-self-help" id="gettingstartedwithremoteactions-self-help"></a>

Use remote actions to help employees solve issues without requiring external intervention from support.

* Set a remote action [triggering mechanism](/platform/user-guide/remote-actions/setting-up-and-managing-remote-actions/creating-remote-actions.md#triggering) via **Spark** and [enable Spark's permission](/platform/user-guide/spark/setting-up-and-managing-spark/managing-agent-actions.md#enabling-spark-permissions) to execute it on employee devices.
* Run remote actions [in conjunction with Nexthink Campaigns](/platform/user-guide/campaigns/managing-campaigns/creating-campaigns/types-of-campaigns.md#typesofcampaigns-targetevaluationandre-evaluation) in self-help scenarios. Use campaigns to notify employees about issues and ask them to take action.

How you run self-help remote actions depends on whether the script payload requires administrative privileges. Run the remote action:

* In the context of the current active user, if the action requires no special privileges.
* In the context of the local system account, if the action requires administrative privileges.

Refer to the [Creating and configuring remote actions > Advanced configuration](/platform/user-guide/remote-actions/setting-up-and-managing-remote-actions/creating-remote-actions.md#advanced-configuration) documentation for more information.

{% hint style="info" %}
Additionally, Remote Actions utilizes an API to programmatically launch remote actions, extending their availability to third-party products, such as self-service portals or ticketing systems. Refer to the [Remote Actions API](https://docs.nexthink.com/api/remote-actions) documentation for more information.
{% endhint %}

#### Self-healing <a href="#gettingstartedwithremoteactions-self-healing" id="gettingstartedwithremoteactions-self-healing"></a>

Use remote actions to fully automate the remediation of specific issues on employee devices, avoiding human intervention.

* [Schedule remote actions](/platform/user-guide/remote-actions/setting-up-and-managing-remote-actions/creating-remote-actions/scheduling-remote-actions.md) to run automatically on one or more devices using Nexthink Query Language (NQL). Consider the frequency of execution for this type of remote action. Monitor their success with remote action dashboards.
* Set a remote action trigger to **Workflow** and include it as part of an automated process.

Refer to the [Remote action thinklet](/platform/user-guide/workflows/creating-workflows/configuring-thinklets/remote-action-thinklet.md) documentation for information.

#### On-demand data <a href="#gettingstartedwithremoteactions-on-demanddata" id="gettingstartedwithremoteactions-on-demanddata"></a>

Use remote actions to get additional data from devices and incorporate it into Nexthink.

* [Schedule remote actions](/platform/user-guide/remote-actions/setting-up-and-managing-remote-actions/creating-remote-actions/scheduling-remote-actions.md) periodically on specific devices to gather additional information that Nexthink does not collect by default.
* Make a diagnostic remote action available for **Spark** to accelerate troubleshooting.

Refer to the [Manage remote actions](/platform/user-guide/remote-actions/setting-up-and-managing-remote-actions/managing-remote-actions.md) documentation for more information on how to execute remote actions on demand using Nexthink Query Language (NQL).

***

### System remote actions

Remote Actions module includes system remote actions available in your Nexthink instance by default. This helps you extend Nexthink diagnostics capabilities, enhance troubleshooting and populate dashboards with additional, specific data points.

* Go to [Manage Remote Actions](/platform/user-guide/remote-actions/setting-up-and-managing-remote-actions/managing-remote-actions.md) page and find remote actions with **System** origin.
* Go to [Nexthink Library](/platform/user-guide/nexthink-library.md) and select specific system remote action to find out more.

{% hint style="info" %}
System Remote actions do not impact your maximum license count.
{% endhint %}

***

### Remote actions from Nexthink Library

Install and customize remote actions from the [Nexthink Library](/platform/user-guide/nexthink-library.md) to enhance Nexthink diagnostics and remediation capabilities across various areas.

Refer to [Library packs](/platform/library-packs.md) for more information.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.nexthink.com/platform/user-guide/remote-actions/setting-up-and-managing-remote-actions.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.