# Criando SURICATO\_HOME

## Visão Geral

Este módulo descreve o procedimento de criação e edição manual da variável de ambiente `SURICATO_HOME` no sistema operacional Windows. 

Esta variável define o diretório raiz de instalação do sistema Suricato, sendo utilizada por aplicações, serviços automáticos, scripts de integração e ferramentas administrativas para a localização de arquivos essenciais.

## Regras de Negócio

* **Escopo Global:** A variável deve ser obrigatoriamente criada na seção de Variáveis do Sistema (System Variables) para garantir que todos os serviços em segundo plano tenham acesso ao caminho mapeado.
* **Integridade de Caminho:** O valor da variável deve apontar exatamente para a pasta raiz onde o sistema Suricato foi instalado, sem barras adicionais ao final do caminho.
* **Dependência de Inicialização:** A ausência ou erro de preenchimento desta variável resulta em falhas generalizadas de localização de diretórios, impedindo a execução dos componentes do sistema.

## Como criar a Variável de Ambiente manualmente

As variáveis de ambiente são usadas no sistema operacional Microsoft Windows e sua inicialização, seguindo a sequência usada pelo modo de instalação automática.

Siga o fluxo de navegação conforme o idioma do seu sistema operacional para acessar a interface de configuração:

* **No Windows em Português:** Acesse Sistema > Configurações Avançadas do Sistema > Variáveis de Ambiente.
* **No Windows em Inglês:** Acesse System > Advanced System Settings > Environment Variables.

Após abrir a janela de configuração, execute as etapas abaixo:

{% stepper %}
{% step %}
Vá até o bloco Variáveis do Sistema (System Variables).
{% endstep %}

{% step %}
Clique no botão **Novo** (New) para criar uma nova variável, ou clique em **Editar** (Edit) caso necessite alterar uma existente.
{% endstep %}

{% step %}
Preencha os campos com as informações exatas do sistema:

* **Nome da variável:** `SURICATO_HOME`
* **Valor da variável:** Inira o caminho do diretório raiz de instalação do Suricato.
  {% endstep %}

{% step %}
Clique em **OK** em todas as janelas abertas para salvar e aplicar a nova configuração.

<figure><img src="/files/BVmNPnc18POImzaJGCrO" alt=""><figcaption><p><em>Variável de Ambiente SURICATO_HOME</em></p></figcaption></figure>
{% endstep %}
{% endstepper %}

## FAQ - Perguntas Frequentes

<details>

<summary>Os componentes do Suricato apresentam falhas intermitentes ao localizar os diretórios internos.</summary>

Ausência ou digitação incorreta do caminho físico no campo de valor da variável `SURICATO_HOME`.

</details>

<details>

<summary>Por que a variável não funciona quando criada na seção de "Variáveis de Usuário"?</summary>

Serviços em segundo plano rodam sob contas do sistema (como *LocalSystem*) e não conseguem ler variáveis restritas ao perfil do usuário logado.

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://software-telematica-com.gitbook.io/suricato-docs/central-tecnica/instalacao-e-configuracao-de-servicos-do-suricato/instalacao-e-configuracao-do-gerserv/criando-suricato_home.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.