> For the complete documentation index, see [llms.txt](https://software-telematica-com.gitbook.io/suricato-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://software-telematica-com.gitbook.io/suricato-docs/central-tecnica/instalacao-e-configuracao-do-suricato/requisitos-do-sistema.md).

# Requisitos do Sistema

## Visão Geral

Requisitos mínimos e recomendados de software, hardware, portas e arquitetura para o funcionamento do Suricato.

{% hint style="warning" %}

#### Atualização de Requisitos (Versão 3.1)

Para garantir a performance e segurança da nova interface 3.1, as versões de servidor e PHP foram atualizadas. Certifique-se de que o seu ambiente atende aos novos requisitos mínimos:

* [PHP: **8.5.0**](/suricato-docs/central-tecnica/instalacao-e-configuracao-do-suricato/instalacao-do-suricato/atualizacao-do-php.md)
* [Servidor Web: Apache HTTP Server **2.4.66.0** ou **IIS 10**.](/suricato-docs/central-tecnica/instalacao-e-configuracao-do-suricato/instalacao-do-suricato/instalacao-e-atualizacao-do-apache/atualizacao-do-apache.md)

[**Clique para ver o Guia de Atualização →**](/suricato-docs/central-tecnica/instalacao-e-configuracao-do-suricato/instalacao-do-suricato.md)
{% endhint %}

## Regras de Negócio

* [x] Mantenha S.O. e SGBD licenciados e atualizados.
* [x] Collate incorreto causa falhas de leitura e gravação.
* [x] O Suricato exige PHP com extensões: *pdo\_sqlsrv, oci8, curl, gd e openssl.*
* [x] Implemente Arquiteturas B, C ou D conforme o volume de CODINs e necessidade de contingência.
* [x] Atualize as versões PHP: **8.5.0** e Apache HTTP Server: **2.4.66.0** ou **IIS 10**.

### Primeiros Passos

{% stepper %}
{% step %}

#### Verificar sistemas e versões

Servidores e estações devem atender às versões de S.O. recomendadas.
{% endstep %}

{% step %}

#### Instalar componentes de software

Instale Apache, PHP, SGBD e navegadores.
{% endstep %}

{% step %}

#### Configurar portas

Libere as portas de comunicação no firewall.
{% endstep %}

{% step %}

#### Certificado SSL

Valide o certificado para conexões HTTPS.
{% endstep %}

{% step %}

#### Escolher arquitetura

 Defina o modelo (A, B, C ou D) conforme o ambiente.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
**Importante:** Requisitos abaixo do mínimo comprometem a performance e estabilidade do sistema.
{% endhint %}

### Requisitos de Software

<table><thead><tr><th width="202">Categoria</th><th>Especificação Homologada</th></tr></thead><tbody><tr><td><strong>S.O. Servidor</strong></td><td>Windows Server 2019 / 2022</td></tr><tr><td><strong>S.O. Estação</strong></td><td>Windows 10 / 11</td></tr><tr><td><strong>Servidor de Aplicação</strong></td><td>Apache HTTP Server <strong>2.4.66.0</strong> ou <strong>IIS 10</strong></td></tr><tr><td><strong>PHP</strong></td><td>Para a versão <strong>3.1.0</strong> o PHP precisa ser o <strong>8.5.0</strong></td></tr><tr><td><strong>SGBD</strong></td><td>SQL Server 2016–2022 (inglês) ou Oracle 19C–21C</td></tr><tr><td><strong>Collation</strong></td><td>SQL Server (Latin1_General_CI_AS) / Oracle (WE8ISO8859P1).</td></tr><tr><td><strong>SSL</strong></td><td> Domain Validated (autoridade confiável).</td></tr><tr><td><strong>Navegadores</strong></td><td>Chrome, Edge ou Firefox</td></tr></tbody></table>

### Portas TCP / Firewall

```
1365: Conex (Acesso).
1366: ConexReP (Ponto).
443: Servidor Web / HTTPS.
1521: Oracle Client.
1433: SQL Server Client.
5000: Integração TOTVS.

Suriplayer:

443, 1818, 8081: Control ID.
3000: Dimep / Henry / MADIS.
3570, 51000: Top Data.
```

### Requisitos de Hardware

<table><thead><tr><th width="202">Categoria</th><th>Especificação Homologada</th></tr></thead><tbody><tr><td><strong>Servidor SGBD</strong></td><td>Xeon Quad Core / 16GB RAM / 3GB Disco.</td></tr><tr><td><strong>Servidor Aplicação</strong></td><td>Xeon Quad Core / 8GB RAM / 8GB Disco.</td></tr><tr><td><strong>Servidor Conex</strong></td><td>Xeon Quad Core / 16GB RAM (até 500 CODINs) / 32GB RAM (até 1000 CODINs) / 1GB Disco. <br><br><em>(Acima de 1000 CODINs, é necessário adicionar um novo servidor).</em></td></tr><tr><td><strong>Estação de Trabalho</strong></td><td>Intel i5 / 8GB RAM.</td></tr><tr><td><strong>Estação de Monitoramento</strong></td><td>Intel i7 / 8GB RAM.</td></tr></tbody></table>

### Certificados SSL e Segurança

> <mark style="color:$primary;">Certificados para IPs internos não são emitidos desde 2015. Certificados "Self Signed" (autoassinados) são restritos ao uso interno e não possuem confiança pública. Para integração, forneça o arquivo da autoridade certificadora confiável ao Suricato.</mark>

## Modelos de Arquitetura

{% stepper %}
{% step %}

#### Arquitetura A

Implantação padrão, sem redundância.

<figure><img src="https://235558800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjphwa3C6HguhCU8RfNQR%2Fuploads%2FMsEAGwI70SC9moChcCqW%2Fimage.png?alt=media&amp;token=ebd23f9e-1d6b-4e05-b5f0-ef2d6de89b36" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Arquitetura B

Servidor de aplicação e Conex/ConexReP no mesmo host (até 50 CODINs).

<figure><img src="https://235558800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjphwa3C6HguhCU8RfNQR%2Fuploads%2Fis9Aal7mUJlgQeasxxB5%2Fimage.png?alt=media&amp;token=031899fc-163b-42dd-9197-53a7f0832d3d" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Arquitetura C

Contingência de banco de dados (segundo servidor).

<figure><img src="https://235558800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjphwa3C6HguhCU8RfNQR%2Fuploads%2FTRzuzsmLVRCwmlejaZDH%2Fimage.png?alt=media&amp;token=7c25bf9b-b4dc-4a94-8af0-5669a2ba35b7" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Arquitetura D

Contingência de aplicação via Cluster (Master/Slave).

<figure><img src="https://235558800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjphwa3C6HguhCU8RfNQR%2Fuploads%2FXkvTWsHS2BjDfPqvteMi%2Fimage.png?alt=media&amp;token=1c42d147-940a-40d0-94ea-ca74880fb770" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

## FAQ - Perguntas Frequentes

<details>

<summary>Instalação em versões anteriores do Windows Server?</summary>

Não. Suporte restrito às versões 2019 e 2022.

</details>

<details>

<summary>Uso de certificado SSL autoassinado?</summary>

Causa alertas de segurança; conexão não confiável externamente.

</details>

<details>

<summary>Outros SGBDs?</summary>

Não. Apenas SQL Server e Oracle são homologados.

</details>

<details>

<summary>Qual arquitetura escolher?</summary>

Até 50 CODINs: Arquitetura B. Acima disso: C ou D.

</details>

<details>

<summary>Funciona sem HTTPS?</summary>

Não recomendado. HTTPS com certificado válido é obrigatório.

</details>

<details>

<summary>Liberar todas as portas?</summary>

Não. Apenas as portas listadas para os serviços utilizados.

</details>

<details>

<summary>Navegador indicado?</summary>

Chrome ou Edge (versões atuais).

</details>

<details>

<summary>Suporta virtualização? </summary>

Sim, desde que respeite os requisitos mínimos de hardware.

</details>

<details>

<summary>Como posso validar meu certificado SSL?</summary>

Acesse as referências abaixo e valide o tipo “Domain Validated”:

* <https://ajuda.serasa.certificadodigital.com.br/hc/pt-br/articles/360033819971-Diferen%C3%A7as-entre-os-tipos-de-certificado-SSL>
* <https://www.sectigo.com.br/suporte/enderecos-internos.php>

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://software-telematica-com.gitbook.io/suricato-docs/central-tecnica/instalacao-e-configuracao-do-suricato/requisitos-do-sistema.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.