Tactical RMM

Overview

This node integrates with the Tactical RMM API to run shell commands on a specified agent machine remotely. It is useful for system administrators or IT professionals who need to execute scripts, troubleshoot issues, or perform maintenance tasks on remote endpoints without direct access.

Typical use cases include:

• Running diagnostic commands on an agent to gather system information.
• Executing update or patch scripts remotely.
• Automating routine administrative tasks across multiple machines.

For example, you could run a Bash script on a Linux agent to check disk usage or execute a PowerShell command on a Windows agent to retrieve event logs.

Properties

Output

The node outputs JSON data containing the result of the command execution on the agent. This typically includes:

• The standard output and standard error streams from the command.
• Execution status or exit code.
• Any relevant metadata about the command run.

If the command produces binary data, it would be included as part of the output but this node primarily focuses on textual command results.

Dependencies

• Requires an active connection to the Tactical RMM API via an API key credential configured in n8n.
• The target agent must be online and reachable by the Tactical RMM server.
• Proper permissions are needed to execute commands on the agent.

Troubleshooting

• Timeouts: If commands take longer than the specified timeout, they will be aborted. Increase the timeout value if necessary.
• Agent Unreachable: Errors may occur if the agent ID is incorrect or the agent is offline. Verify the agent's status in Tactical RMM.
• Command Errors: Invalid commands or syntax errors in the shell command will return error messages from the shell. Validate commands before running.
• Authentication Issues: Ensure the API key credential is valid and has sufficient permissions.

Links and References

• Tactical RMM Official Documentation
• n8n Documentation - Creating Custom Nodes