> For the complete documentation index, see [llms.txt](https://guia-de-uso.tiflux.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guia-de-uso.tiflux.com/faq/duvidas-frequentes/configuracoes/recursos/agente-remoto/kcs-agente-remoto-erro-de-instalacao-do-agente.md).

# KCS - Agente Remoto - Erro de Instalação do Agente

## ⚙️ KCS - Agente Remoto - Erro de Instalação do Agente

🕒 Tempo aproximado para leitura: 00:01:30 min<br>

***

### ❓ Dúvida / Problema

O usuário enfrenta um erro ao tentar instalar o agente do sistema em sua máquina (ex: *"Erro ao instalar o agente nessa máquina..."*), impedindo a conclusão do processo.<br>

<figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FNwi8fD8XNKgTo0SbdIko%2Fimage.png?alt=media&amp;token=1ef114a5-6c33-4484-9760-38f3d21fa797" alt=""><figcaption></figcaption></figure>

***

### 🔎 Causa / Contexto

O erro de instalação possui duas causas principais:<br>

1. Incompatibilidade ou Ausência do Protocolo TLS 1.2: A chave de registro `force_tls12` não está configurada como `true` ou a própria subchave no Registro do Windows está ausente devido a falhas prévias na instalação, impedindo a comunicação segura necessária com os servidores.<br>
2. Limite de Licenças Excedido: O cliente atingiu a quantidade máxima de agentes inteligentes permitidos pelo seu plano cadastrado no TiFlux.<br>

***

### ✅ Solução / Como Resolver

Colete os logs da instalação para confirmar a causa exata e aplique o procedimento correspondente:<br>

#### Opção 1: Corrigir Incompatibilidade ou Ausência do TLS 1.2

Caso a chave não esteja configurada como `true` ou o caminho de registro do TiFlux ainda não exista na máquina, utilize uma das opções de correção abaixo:<br>

**A) Via PowerShell (Recomendado - Cria a chave se não existir)**

Abra o PowerShell como Administrador e execute o script abaixo para criar o caminho no registro (caso ausente) e definir a propriedade para `true`:\
PowerShell

```
$regPath = "HKLM:\SOFTWARE\TiFlux"

# Cria a chave no Registro caso não exista
if (-not (Test-Path $regPath)) {
    New-Item -Path $regPath -Force | Out-Null
}

# Cria ou altera o valor de force_tls12 para "true"
New-ItemProperty `
    -Path $regPath `
    -Name "force_tls12" `
    -Value "true" `
    -PropertyType String `
    -Force | Out-Null

Write-Host "force_tls12 definido como true."
```

**B) Via Prompt de Comando (CMD)**

Abra o Prompt de Comando (CMD) como Administrador e execute:\
DOS

```
REG ADD "HKEY_LOCAL_MACHINE\SOFTWARE\TiFlux" /v "force_tls12" /t REG_SZ /d "true" /f
```

**C) Manualmente pelo Editor de Registro (Regedit)**

1. Abra o `regedit`.<br>
2. Navegue até o caminho `HKEY_LOCAL_MACHINE\SOFTWARE\TiFlux` (caso a pasta TiFlux não exista em `SOFTWARE`, crie-a manualmente).<br>
3. Crie ou edite a *String Value* `force_tls12` e altere o valor para `true`.<br>

> ⚠️ Aviso: Após alterar ou criar a chave no Registro, reinicie o serviço do agente (TiService) ou refaça a instalação do executável.<br>

#### Opção 2: Aumentar o Limite de Licenças

Se os logs indicarem teto de agentes atingido:<br>

* O cliente deve entrar em contato com o CSM (Customer Success Manager) de sua conta para solicitar a expansão do limite de agentes inteligentes.<br>

> 💡 Dica de Especialista / Nota: Em máquinas sem instalações prévias do TiFlux, a pasta do registro em `HKLM:\SOFTWARE\TiFlux` pode não ter sido gerada. Nesses cenários, utilize preferencialmente o script do PowerShell (Opção A), pois ele cria a estrutura de diretórios e a chave de forma automatizada sem gerar erros de caminho não encontrado.

***

### 🔍 Palavras-chave para busca

```
erro ao instalar agente nessa maquina tiflux,
falha instalacao agente remoto force_tls12,
criar chave force_tls12 regedit powershell,
script powershell registrar force_tls12 tiflux,
agente remoto limiar de licencas excedido,
tiservice nao conecta tls 12 registro
```