Actions12
Overview
The "Run Script on Agent" operation in the Tactical RMM Agents node allows users to remotely execute a script on a specified agent managed by the Tactical RMM platform. This is useful for automating maintenance tasks, running diagnostics, or deploying quick fixes without needing direct access to the agent machine.
Typical scenarios include:
- Running custom scripts to gather system information.
- Applying patches or configuration changes remotely.
- Automating repetitive administrative tasks across multiple agents.
For example, an IT administrator could use this node to run a cleanup script on an agent that is experiencing performance issues.
Properties
| Name | Meaning |
|---|---|
| Agent ID | The unique identifier of the agent on which the script will be executed. |
Output
The node outputs a JSON array containing the response from the Tactical RMM API after attempting to run the script on the specified agent. The exact structure depends on the API's response but generally includes details about the execution status, any output or errors from the script, and metadata related to the request.
No binary data output is produced by this operation.
Dependencies
- Requires an active connection to the Tactical RMM API via an API key credential.
- The node expects the base URL and API key for the Tactical RMM instance to be configured in the credentials.
- Network connectivity to the Tactical RMM server is necessary.
Troubleshooting
Common Issues:
- Invalid or missing Agent ID: Ensure the Agent ID provided corresponds to an existing agent.
- Authentication failures: Verify that the API key credential is valid and has sufficient permissions.
- Network errors: Confirm that the Tactical RMM server is reachable from the n8n environment.
Error Messages:
- API errors returned by the Tactical RMM server will be surfaced as node errors. These may indicate invalid parameters, permission issues, or server-side problems.
- If the node throws a generic request error, check the network connection and credential validity.
Links and References
- Tactical RMM Official Documentation
- Tactical RMM API Reference (for detailed API endpoints and responses)