Getting Started with RMM

This guide walks you through enrolling your first device and running your first remote command in about 10 minutes.

Step 1: Open RMM from the Waffle Menu

1. Sign in to Hub with your MSP account.
2. Click the waffle menu (grid icon) in the top-left corner of the Hub Bar.
3. Select RMM. You will land on the Devices dashboard at app.theonermm.app.

Step 2: Download the Agent Installer

1. In the RMM console, click Devices in the left sidebar.
2. Click Add Devices in the top-right corner.
3. Select the target platform:
   • Windows — downloads a .msi installer
   • macOS — downloads a .pkg installer
   • Linux — shows the appropriate .deb or .rpm package command
4. Your enrollment token is embedded in the installer. Each download is pre-bound to your tenant.

Step 3: Enroll Your First Windows Device

1. Copy the downloaded .msi file to the target Windows device (or run directly from a network share).
2. Double-click the installer and follow the on-screen prompts — or run silently:

   msiexec /i TheOneRMM-Agent.msi /quiet

3. The agent installs as a Windows service (TheOneRMMAgent) and starts automatically.
4. Within 60 seconds the device sends its initial enrollment payload to api.theonermm.app.

Step 4: Verify the Device Appears in the Console

1. In the RMM console, navigate to Devices.
2. Your new device should appear within 1–2 minutes. The status indicator will be Online (green).
3. Click the device name to open the Device Detail view. Verify:
   • Hostname, OS version, and IP address are correct
   • The Agent Version field shows the current version
   • The Modules section shows RMM as active

Device Not Appearing?

See Troubleshooting — Device not appearing in console.

Step 5: Create Your First Alert Rule

1. Navigate to Alert Rules in the left sidebar.
2. Click New Rule.
3. Configure a basic CPU threshold alert:
   • Name: High CPU Usage
   • Type: Threshold
   • Metric: CPU Usage
   • Condition: Greater than 90%
   • Duration: 5 minutes
   • Severity: Warning
   • Action: Send notification
4. Click Save. The rule applies to all devices in your tenant by default. You can scope it to specific device groups later.

Step 6: Run Your First Remote Command

1. Navigate to Devices and click your enrolled device.
2. Click Remote Commands in the device detail tabs.
3. Click New Command.
4. Select the command type:
   • PowerShell for Windows
   • Bash for macOS/Linux
5. Enter a simple command, for example:

   Get-ComputerInfo | Select-Object CsName, WindowsVersion, TotalPhysicalMemory

6. Click Run. The command dispatches immediately and results appear within seconds.
7. Output is captured and stored in the Execution History tab.

What's Next

Topic	Where to Go
Deploy to many devices at once	Agent Installation — Group Policy and MDM
Set up patch management	Patch Management
Build automation scripts	Automation Scripts
Configure alert-to-ticket integration	Integrations