Skip to content
RevoDocs

Troubleshooting

Fixes for the problems technicians run into most often, by area.

Updated

On this page

Start with what the page itself says. Revo shows a reason wherever it can (a coverage gap, a skipped device, a signal that isn't available), and that reason is usually the fastest route to a fix.

Account and access

ProblemWhat to do
"Confirm your email" banner; can't run assessments or create reportsClick the link in the verification email, or Resend. Until then you can look around but not scan, report, invite or deploy agents.
Lost your authenticatorUse a recovery code, or ask an admin to reset your MFA in Settings → Team. See Account security.
A page or action is missingYour role may not include it. See Roles and permissions. Areas whose module isn't active may also be hidden: use Show inactive (see Modules).
Can't turn on patch managementYour account needs two-factor authentication on, and you must be an owner or admin.

Assessments

ProblemWhat to do
Active scan stuck in pending approvalAn admin must approve it, and the domain must be verified. See Scope and authorization.
Domain won't verifyCheck the TXT record is published on the domain's own nameservers. Pending domains are re-checked automatically for 14 days. See Verify a domain.
Report shows a Coverage noticeSome checks couldn't run (a timeout, a source not enabled). Re-run the assessment; don't read "not checked" as "no issues".
Can't start a new assessment or reportYou may have hit the plan's monthly assessments, or two reports are already generating. Check Settings → Billing, or wait for the current reports.

Devices

ProblemWhat to do
Device shows Offline or No recent dataCheck the computer is on and has direct outbound HTTPS. Proxies aren't supported. See Troubleshooting devices.
Agent stopped after an updateThe agent service may need starting. On Windows with ThreatLocker, check for a pending approval of the new agent hash. See Allowlist the agent.
SmartScreen warns about the installerExpected: the Windows agent isn't Authenticode-signed yet. Use the PowerShell command or MSI through your RMM. See Install on Windows.
Device shows agent too oldTurn on automatic agent updates or use Update agent. See Device actions.

Patching and upgrades

ProblemWhat to do
Nothing installsRead Patching → Status → What's blocking 100%. Common causes: patch management off for the customer, the workspace paused, updates waiting for approval, the device's local switch off, no maintenance window yet. See How patch management works.
Device skipped in a deploymentThe deployment lists the reason per device (offline, agent too old, turned off locally, nothing to install, missed window). See Deployments.
Windows upgrade failedThe device shows Windows' error code and what to do. See Troubleshooting Windows upgrades.
Mac update shows needs a signed-in owner or MDMOn Apple silicon, only the Mac's owner or an MDM can approve macOS system updates. See macOS and Linux updates.

Microsoft 365

ProblemWhat to do
"Set up Microsoft 365 for your workspace first"An owner or admin sets up the workspace app in Settings → Integrations. See Connect Microsoft 365.
"Reconnect to grant the permission"Send the customer's administrator a new consent link from Customer settings → Integrations.
"Needs Microsoft Entra ID P1/P2"The tenant's licence doesn't include that signal. Nothing to fix in Revo.
"The last sync failed"The pages keep showing the last good data. Check the connection on Customer settings → Integrations, then Sync now.

Integrations

ProblemWhat to do
GitHub connection shows Needs attentionThe token expired, the app was uninstalled or your workspace's app was replaced. Connect again. See Connect GitHub.
ThreatLocker modes are blankThe account may return different field names than expected. Contact support. See Connect ThreatLocker.
Webhook deliveries failThe endpoint must answer 2xx over HTTPS on a public address. Use Test, and check your signature verification. See Webhooks.

Still stuck?

Open Support in the sidebar to contact Revo support. If support needs to look at your customers' data, you'll be asked to grant time-limited access (see How your data is protected).