> ## 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.

# O Gorelo Agent não instala

> Resolva falhas de instalação do Gorelo Agent com a verificação de pré-requisitos por PowerShell, lista de SOs suportados e correções comuns para Windows e macOS.

Ocasionalmente, você pode encontrar problemas ao instalar o Gorelo Agent. Veja alguns pontos a considerar.

## Sistemas operacionais suportados

O Gorelo só oferece suporte a sistemas operacionais atualmente suportados pelos próprios fornecedores (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)

## Verificação de pré-requisitos via PowerShell

O Gorelo oferece uma verificação simples de pré-requisitos via PowerShell que você pode executar.

1. Abra uma janela do PowerShell com privilégios elevados no computador com problema.
2. Cole o seguinte comando e pressione **Enter**:

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

3. Resolva quaisquer falhas conforme abaixo e garanta que a correção persista entre sessões PowerShell e reinicializações.

| Verificação                     | **❌ Mensagem de falha**                                                                                                                                                                                                                                                                                                                          | **✅ Solução**                                                                                                                                                                                                                                                                                                                            |
| :------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Versão do PowerShell**        | `FAIL: PowerShell version X.X is below the required version 5.1`                                                                                                                                                                                                                                                                                 | <ul><li>Baixe e instale o Windows Management Framework 5.1 pela Microsoft</li><li>No Windows 10/11, use o Windows Update para atualizar o PowerShell</li><li>Verifique a instalação com `$PSVersionTable.PSVersion`</li></ul>                                                                                                            |
| **Espaço em disco do sistema**  | <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>Execute a Limpeza de Disco para liberar espaço</li><li>Procure e remova arquivos grandes desnecessários</li><li>Verifique se o disco do sistema está acessível e montado corretamente</li><li>Verifique a integridade com `chkdsk /f`</li></ul>                                                                                  |
| **Arquitetura do processador**  | `FAIL: Non-64-bit processor architecture detected: X`                                                                                                                                                                                                                                                                                            | <ul><li>Verifique se o sistema atende aos requisitos de 64 bits</li><li>Verifique se o Windows 32 bits está rodando em hardware 64 bits</li></ul> ARM64 é suportado, por exemplo, Snapdragon                                                                                                                                             |
| **Permissão no registro**       | `FAIL: Registry read/write permission check. Error: [specific error]`                                                                                                                                                                                                                                                                            | <ul><li>Execute o script como administrador</li><li>Verifique as permissões em HKLM:\SOFTWARE\Gorelo</li><li>Verifique se o antivírus não está bloqueando o acesso ao registro</li><li>Use o RegEdit para verificar acessibilidade da chave</li></ul>                                                                                    |
| **Acessibilidade de URLs**      | `FAIL: URL check for [Description] ([URL]). Error: [specific error] `                                                                                                                                                                                                                                                                            | <ul><li>Verifique a conectividade com a internet</li><li>Verifique a resolução de DNS (`nslookup` no domínio)</li><li>Verifique as configurações do firewall</li><li>Verifique as configurações de proxy, se aplicável</li></ul>                                                                                                         |
| **Permissão de log de eventos** | `FAIL: Event log read/write permission check. Error: [specific error]`                                                                                                                                                                                                                                                                           | <ul><li>Execute o script como administrador</li><li>Verifique se o serviço EventLog está em execução (`Get-Service EventLog`)</li><li>Verifique as permissões no log de Aplicativos</li><li>Verifique manualmente a funcionalidade do Visualizador de Eventos</li></ul>                                                                  |
| **Variável de ambiente**        | <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>Verifique a variável PATH do sistema em Propriedades do Sistema</li><li>Verifique a estrutura de diretórios do Windows</li><li>Repare/restaure o PATH do sistema, se modificado</li><li>Compare com a variável PATH de um sistema funcional</li></ul>                                                                            |
| **Sincronização de horário**    | `FAIL: Time mismatch detected! [time details]`                                                                                                                                                                                                                                                                                                   | <ul><li>Verifique se o serviço Windows Time está em execução</li><li>Force a sincronização: `w32tm /resync`</li><li>Verifique as configurações de fuso horário</li><li>Verifique a conectividade com [**time.windows.com**](http://time.windows.com)</li><li>Configure a sincronização automática nas configurações do Windows</li></ul> |

## Logs

O Gorelo registra tudo em:

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

À medida que a instalação avança, o instalador cria pastas adicionais em cada estágio com arquivos de log:

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

Sinta-se à vontade para investigar os seguintes logs — é onde os problemas mais comuns aparecerão:

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

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

Se o suporte do Gorelo pedir arquivos de log, envie toda a pasta **LogFiles** como um .zip.

## Ainda com problemas?

Se você continuar com problemas de instalação após resolver todas as falhas do **Gorelo Agent Check**, entre em contato diretamente com o suporte do Gorelo. Use o chat de suporte pelo ícone "?" no menu inferior esquerdo.