Troubleshooting Unattended Agent Installation Issues on Windows Devices

    Zoho Assist installation may fail after successful download and extraction due to the following causes:

    • Account not authorized or not a member of the organization
    • License limit exceeded or invalid authentication key
    • Antivirus or security software blocking installation
    • Insufficient disk space or unsupported Windows version
    • Previous Zoho Assist installation interfering with new installation

    Use the steps below to identify the cause and complete the installation.

    Prerequisites

    Check the following before troubleshooting:

    • The device has a stable internet connection.
    • The installer or deployment link was shared by your Zoho Assist administrator.
    • The device meets the Windows 7 or later requirements (Learn more about supported operating system requirements).
    • Antivirus, firewall, or endpoint security tools are not blocking the installer.

    Account & Authorization Issues

    Issue: Not a Member of This Organization

    Possible Cause:
    Your account is not associated with the organization that created the deployment link or authentication key.

    Recommended Steps:

    • Confirm that you are using the correct Zoho Assist organization account.
    • Check whether your email address has been added to the organization.
    • Complete email verification if prompted.
    • Contact your Zoho Assist administrator and ask them to verify:
      • Organization membership
      • Technician role or deployment permissions
      • Department access
    • Try installing the agent again after the required access is granted.

    Issue: Deployment Permission Denied

    Possible Cause:
    Your account does not have permission to deploy unattended agents in the organization.

    Recommended Steps:

    • Contact your Zoho Assist administrator.
    • Ask them to grant you deployment permissions.

    Issue: No Access to Department

    Possible Cause:
    You are trying to install the agent under a department you do not have access to.

    Recommended Steps:

    • Contact your Zoho Assist administrator.
    • Request access to the required department.

    Network & Connectivity Issues

    You may see errors such as:

    • Cannot connect to server / Unable to connect to server / Cannot reach Zoho Servers
    • Connection failed / Network connection failed
    • The installation hangs or times out

    Possible Cause:
    The installer is unable to reach Zoho Assist servers. This may happen due to an unstable internet connection, firewall restrictions, proxy settings, or network security policies.

    Recommended Steps:

    • Open a web browser on the affected device.
    • Visit https://assist.zoho.com and verify the page loads.
    • If the page doesn't load, restore internet connectivity before trying to connect again.

    License & Quota Issues

    Issue: License Limit Exceeded

    Possible Cause:
    The organization has reached the maximum number of unattended devices allowed by the current Zoho Assist subscription.

    Recommended Steps:

    • Contact your Zoho Assist administrator and ask them to check the available unattended access license count.
    • Remove inactive or unused devices from the Zoho Assist portal if required.
    • Upgrade the subscription plan if more unattended devices are needed.

    Issue: Invalid Authentication Token or Expired Authentication Key

    Possible Cause:
    The deployment link or authentication key is no longer valid for the selected department or organization.

    Recommended Steps:

    • Confirm the deployment link is intended for the correct organization and department.
    • Avoid using old installer files or previously downloaded deployment packages.
    • Download the latest installer from your administrator and try the installation again.

    You may see error messages such as:

    • "Deployment link expired"
    • "Invalid deployment link"
    • "Link has been deactivated"

    Possible Cause:

    • Deployment link or authentication key has expired or is no longer valid.
    • Link has been deactivated by the admin.

    Recommended Steps:

    • Check with your admin if the link has been intentionally deactivated. If so, request a new deployment link and try again.

    Issue: Department Configuration Inactive

    Possible Cause:
    The department you're trying to install to has been deactivated.

    Recommended Steps:

    • Contact your org admin to request activation of the department, or use a deployment link for an active department instead.

    Antivirus & Security Software Issues

    Issue: Antivirus or Security Software Blocking Installation

    You may see errors such as:

    • The installation stops suddenly.
    • Installation files disappear after extraction.
    • A threat detection notification appears.
    • Installation files are moved to quarantine.
    • The Zoho Assist service fails to start.

    Possible Cause:
    Antivirus, Windows Security, or endpoint protection software is blocking the installer or extracted files.

    Recommended Steps:

    • Open your antivirus or endpoint security application.
    • Check the quarantine or blocked items list.
    • Look for files related to "Zoho" or "ZADeployer".
    • Restore the files (only if downloaded from a trusted Zoho Assist deployment link).
    • Add the following to your antivirus allowed list:
      • C:\Program Files\ZohoMeeting\
      • C:\Program Files (x86)\ZohoMeeting\
      • The Zoho Assist installer file location

    For Windows Security:

    • Open Windows Security.
    • Go to Virus & threat protection.
    • Open Manage settings.
    • Add the required exclusion paths (listed above) under Exclusions.
    • Try installing the agent again.

    For centrally managed endpoint security:

    • Contact your IT security team to allow/whitelist Zoho Assist before retrying.

    Issue: Installation Blocked by Security Policy

    You may see errors such as:

    • Installation blocked by security policy
    • The installer does not open.
    • The installation stops before completion.

    Possible Cause:
    The device is restricted by organization-level security policies preventing software installation.

    Recommended Steps:

    • Contact your IT administrator or help desk.
    • Ask them to approve Zoho Assist installation on the device.
    • Request deployment through your organization's approved method if needed:
      • Group Policy
      • SCCM
      • Microsoft Intune
      • Other device management tools
    • Retry the installation after the policy restriction is resolved.

    System Requirements & Compatibility

    Issue: Insufficient Disk Space

    Possible Cause:
    The device does not have enough storage space.

    Recommended Steps:

    • Open File Explorer.
    • Go to This PC.
    • Check available space on the system drive (usually C:).
    • Free up space by:
      • Emptying the Recycle Bin
      • Deleting temporary files
      • Removing unused applications
      • Moving large files to another drive
    • Restart the device and try the installation again.

    Issue: Previous Installation Detected

    Possible Cause:
    Files or services from an earlier Zoho Assist or Zoho Meeting installation are interfering with the new installation.

    Recommended Steps:

    • Open Control Panel.
    • Go to Programs and Features.
    • Look for Zoho Assist or Zoho Meeting.
    • Uninstall the existing application if found.
    • Open Task Manager.
    • End any running processes related to Zoho or ZohoMeeting.
    • Check if these folders still exist and delete them:
      • C:\Program Files\ZohoMeeting\
      • C:\Program Files (x86)\ZohoMeeting\
    • Restart the device.
    • Run the latest installer again.

    Issue: Unsupported or Outdated Windows Version

    Possible Cause:
    The Windows version does not meet the minimum requirements for installing the Zoho Assist unattended agent.

    Recommended Steps:

    • Check the Windows version installed on the device.
    • Install the latest available Windows updates.
    • If running Windows 7, confirm Service Pack 1 and all required updates are installed.
    • If the OS is no longer supported, upgrade to a supported Windows version.
    • Try the installation again.

    Supported versions: Windows 7 (with latest updates), Windows 8/8.1, Windows 10, Windows 11, Windows Server 2008 R2 and later.

    Issue: Installer Version is Outdated

    Possible Cause:
    The installer file is outdated or no longer valid.

    Recommended Steps:

    • Delete the old installer file.
    • Request a fresh deployment link from your Zoho Assist admin, or download the latest installer.
    • Run the installation again.

    Note: Don't use installer files older than 6 months.

    If you've tried the troubleshooting steps above and the issue persists, please contact us at support@zohoassist.com.

    PREVIOUS

    UP NEXT