---
title: "Agent Failed to Install"
slug: "agent-failed-to-install"
updated: 2025-09-02T07:01:04Z
published: 2025-09-02T07:01:04Z
canonical: "support.controlup.com/agent-failed-to-install"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://support.controlup.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent Failed to Install

This article describes some common problems during Agent installation, and how to fix them.

## Issue #1 - “The Agent Authentication Key is misconfigured”
This error appears when the agent was installed on the machine with the MSI package, but no authentication key was provided. 

### Solution

1. Open the Real-Time Console > **Agent Settings** > click the **Copy** button under **Agents Authentication Key**.
2. Enter the registry on the agent machine. 
Under <code>HKLM\SOFTWARE\Smart-X\ControlUp\Agent\Communication</code>, add the copied authentication key to the **AuthKey** value data (type: **REG_SZ**).
![HKLM\SOFTWARE\Smart-X\ControlUp\Agent\Communication](https://cdn.document360.io/098100b7-b9da-4bea-b4b9-017140ab863e/Images/Documentation/image-MMNVX1B0.png){height="" width=""}

3. Re-connect the agent machine in the console.
![agent machine connected](https://cdn.document360.io/098100b7-b9da-4bea-b4b9-017140ab863e/Images/Documentation/image-2B6VRP37.png){height="" width=""}

## Issue #2 - “Validating RPC availability. Failed to access \\hostname\admin$”
This error usually appears when the firewall settings are not configured correctly. During the deployment of the Agent. Deploying the agent requires the logged in user on the console machine to be able to access the administrative share on the agent machine. 

![image.png](https://cdn.document360.io/098100b7-b9da-4bea-b4b9-017140ab863e/Images/Documentation/image-N2BHXKUZ.png){height="" width=""}

### Solution
Make sure all required firewall ports are open. Refer to the [communication ports](https://support.controlup.com/tim-reorg/docs/communication-ports-used-by-controlup-hybrid-cloud-1#connectivity-to-devices-and-services-in-your-network) article.