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

# Gorelo Agent won't install

> Troubleshoot Gorelo Agent installation failures with the PowerShell prerequisite check, supported OS list, and common fixes for Windows and macOS endpoints.

Occasionally, you may run into issues installing the Gorelo Agent. Here are a few things to consider.

## Supported operating systems

Gorelo only supports operating systems that are currently supported by the vendor themselves (Microsoft/Apple).

* [**<u>https://endoflife.date/windows</u>**](https://endoflife.date/windows)
* [**<u>https://endoflife.date/windows-server</u>**](https://endoflife.date/windows-server)
* [**<u>https://endoflife.date/macos</u>**](https://endoflife.date/macos)

## Prerequisite check via PowerShell

Gorelo provides a simple prerequisite check via PowerShell that you can run.

1. Open an elevated PowerShell window on the computer experiencing agent issues.
2. Paste the following command and press **Enter**:

```text theme={null}
Invoke-Expression (Invoke-WebRequest -Uri "https://gist.githubusercontent.com/mikelgorelo/e5bcac91d2fddd165a2fd56a675ebb3a/raw/dd21bcf13480e366a569ae06fa43b9f3c57fa5d8/gorelo-check.ps1" -UseBasicParsing).Content
```

3. Work through resolving any failures, as per below, and make sure this persists across PowerShell sessions and reboots.

| Check                            | **❌ Failure Message**                                                                                                                                                                                                                                                                                                                            | **✅ Troubleshooting**                                                                                                                                                                                                                                                                         |
| :------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **PowerShell Version Check**     | `FAIL: PowerShell version X.X is below the required version 5.1`                                                                                                                                                                                                                                                                                 | <ul><li>Download and install Windows Management Framework 5.1 from Microsoft</li><li>For Windows 10/11, use Windows Update to update PowerShell</li><li>Verify installation with `$PSVersionTable.PSVersion`</li></ul>                                                                        |
| **System Drive Space Check**     | <ul><li>`FAIL: Free space is less than 300 MB (Current: X MB)`</li><li>`FAIL: Unable to get drive info`</li><li>`FAIL: Unable to get System Drive`</li></ul>                                                                                                                                                                                     | <ul><li>Run Disk Cleanup to free up space</li><li>Check for and remove large unnecessary files</li><li>Verify system drive is accessible and mounted correctly</li><li>Check disk health with `chkdsk /f`</li></ul>                                                                           |
| **Processor Architecture Check** | `FAIL: Non-64-bit processor architecture detected: X`                                                                                                                                                                                                                                                                                            | <ul><li>Verify system meets 64-bit requirements</li><li>Check if running 32-bit Windows on 64-bit capable hardware</li></ul> ARM64 is supported, e.g., Snapdragon                                                                                                                             |
| **Registry Permission Check**    | `FAIL: Registry read/write permission check. Error: [specific error]`                                                                                                                                                                                                                                                                            | <ul><li>Run script as administrator</li><li>Check permissions on HKLM:\SOFTWARE\Gorelo</li><li>Verify antivirus isn't blocking registry access</li><li>Use RegEdit to check registry key accessibility</li></ul>                                                                              |
| **URL Accessibility Checks**     | `FAIL: URL check for [Description] ([URL]). Error: [specific error] `                                                                                                                                                                                                                                                                            | <ul><li>Check internet connectivity</li><li>Verify DNS resolution (`nslookup` the domain)</li><li>Check firewall settings</li><li>Verify proxy settings if applicable</li></ul>                                                                                                               |
| **Event Log Permission Check**   | `FAIL: Event log read/write permission check. Error: [specific error]`                                                                                                                                                                                                                                                                           | <ul><li>Run script as administrator</li><li>Check Event Log service is running (`Get-Service EventLog`)</li><li>Verify permissions on Application event log</li><li>Check Event Viewer functionality manually</li></ul>                                                                       |
| **Environment Variable Check**   | <ul><li>`FAIL: The PATH environment variable contains 'system32' but not 'System32\WindowsPowerShell\v1.0'`</li><li>`FAIL: The PATH environment variable contains 'System32\WindowsPowerShell\v1.0' but not 'system32'`</li><li>`FAIL: The PATH environment variable does not contain 'system32' or 'System32\WindowsPowerShell\v1.0'`</li></ul> | <ul><li>Check System PATH variable in System Properties</li><li>Verify Windows directory structure</li><li>Repair/restore system PATH if modified</li><li>Compare with working system's PATH variable</li></ul>                                                                               |
| **Time Synchronization Check**   | `FAIL: Time mismatch detected! [time details]`                                                                                                                                                                                                                                                                                                   | <ul><li>Check Windows Time service is running</li><li>Force time sync: `w32tm /resync`</li><li>Verify time zone settings</li><li>Check network connectivity to [**time.windows.com**](http://time.windows.com)</li><li>Configure automatic time synchronization in Windows settings</li></ul> |

## Logs

Gorelo logs everything to:

```text theme={null}
%programfiles%\Gorelo\LogFiles\ 
```

As the install progresses, the installer creates additional folders at each stage with log files inside:

**InstallerHandler** > **Installer** > **Shell > Agent**

Feel free to investigate the following logs -- this is where the most common issues will appear:

```text theme={null}
%programfiles%\Gorelo\LogFiles\Installer\diagnostics**.log
```

```text theme={null}
%programfiles%\Gorelo\LogFiles\Agent\diagnostics**.log
```

If Gorelo support asks for log files, send the entire **LogFiles** folder as a .zip.

## Still having problems?

If you're still experiencing installation issues after resolving all failures in the **Gorelo Agent Check**, contact Gorelo support directly. Use the support chat via the "?" icon in the bottom-left menu.