> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/on-premise/pt-br/on-premise/how-to-guide/troubleshooting/web-interface.md).

# Interface web

Esta página fornece um guia abrangente para solução de problemas dos erros mais comuns encontrados na interface web Navixy On‑premise. Cobre tanto o Painel Admin quanto a Interface do Usuário, pois ambos compartilham o servidor web Nginx, resultando em ocorrências de erro semelhantes. Explore este recurso para resolver efetivamente quaisquer problemas e otimizar sua experiência.

<details>

<summary>Página de boas-vindas do Nginx</summary>

Se você visualizar a tela de boas-vindas do Nginx, isso significa que a solicitação passou pelo servidor e o Nginx está instalado e em execução, mas ainda não foi configurado.

![Bem-vindo ao Nginx](/files/656152d2a72c6cb1b03e0f44e24e2e9dc07352e0)

Itens a verificar:

* As configurações do site estão armazenadas no seguinte diretório:
  * Linux: `/etc/nginx/sites-available`
  * Windows: `C:\nginx\conf\sites-enabled`
* Em instâncias Linux, os links simbólicos para esses arquivos devem ser criados em `/etc/nginx/sites-enabled`

Se não houver configurações presentes - entre em contato com a equipe de suporte da Navixy.

</details>

<details>

<summary>Este site não pode ser acessado (DNS_PROBE_FINISHED_NXDOMAIN)</summary>

O erro DNS\_PROBE\_FINISHED\_NXDOMAIN significa que seu domínio não está apontando para seu servidor ou está configurado incorretamente.

![DNS\_PROBE\_FINISHED\_NXDOMAIN](/files/b7c99ef0661617518bb6ea4a819fed895e04eb0b)

Para resolver o problema, verifique se os registros DNS do domínio estão especificados corretamente.

Domínios devem ter um registro DNS do tipo A para funcionarem. Por favor, verifique [requisitos do domínio](/docs/on-premise/pt-br/on-premise/how-to-guide/requirements/domains.md) para mais detalhes.

</details>

<details>

<summary>Este site não pode ser acessado (ERR_CONNECTION_REFUSED/TIME_OUT)</summary>

Este erro significa que as tentativas de conexão falharam.

![ERR\_CONNECTION\_REFUSED](/files/196735857b47afc0bae2f08443a2b4a48bedcc82)

Etapas de solução de problemas:

1. Verifique se a porta 80 (HTTP) ou 443 (HTTPS) está aberta e se as conexões são permitidas.
2. [Verifique se o Nginx está iniciado](/docs/on-premise/pt-br/on-premise/how-to-guide/requirements/domains.md).
3. No Linux: verifique se os links simbólicos para as configurações do Nginx foram criados em `/etc/nginx/sites-enabled`.
4. Se você editou qualquer uma das configurações do Nginx - reinicie o Nginx.

</details>

<details>

<summary>404 Not Found</summary>

Se você ver esse erro, significa que o NGINX não está configurado corretamente ou que você está solicitando a URL errada.

![404 not found](/files/6f933ff36e26f966f6c9fb3332566b7294d450ab)

Maneiras possíveis de resolver:

1. Verifique se as URLs nos arquivos de configuração do Nginx estão corretas. Os arquivos estão localizados em `/etc/nginx/sites-available/`
2. No Linux: verifique se os sites necessários estão habilitados. Os sites são habilitados criando links simbólicos em `/etc/nginx/sites-enabled/`
3. Verifique se o local dos arquivos estáticos especificado na configuração do Nginx está correto.

* Para Linux, os arquivos estão localizados em `/var/www/`
* Para Windows, os arquivos estão em `diretório C:\nginx\www`

4. Verifique se as URLs nos arquivos estáticos estão especificadas corretamente. Os arquivos são:

* `./www/panel-v2/PConfig.js`
* `./www/pro-ui/Config.js`
* `./www/pro-ui/static/app_config.js`

5. Se você editou qualquer uma das configurações - reinicie o Nginx.

</details>

<details>

<summary>Ícone de carregamento ou tela “Voltaremos em breve” é exibida</summary>

Se você vir um ícone de carregamento por longos períodos, ou aparecer a tela “Voltaremos em breve” - isso significa que seu servidor web está funcionando e os arquivos estáticos são acessíveis, mas a IU não consegue obter dados da plataforma.

![Erro voltaremos em breve](/files/8972414b1eb2e91462237bd89174c7b758d07053)

![Voltaremos em breve](/files/1efa83fd03804f75d82f58802b155c8dd8d971af)

Para resolver o problema:

1. Se o painel Admin estiver disponível e o problema for apenas com a interface do usuário - verifique se o nome de domínio correto está especificado no Painel Admin (Account Management - Service preferences).
2. Verifique as ferramentas de desenvolvedor do seu navegador. Em navegadores baseados no Chrome, pressione F12, acesse Rede, recarregue a página e verifique os erros. Se você ver que `get_ui_config` a chamada de API falha ao ser executada, na maioria dos casos isso significa que o servidor API está fora do ar.
3. [Verifique o status do servidor API](/docs/on-premise/pt-br/on-premise/how-to-guide/troubleshooting/checking-service-statuses.md). Se o serviço estiver parado - tente reiniciá‑lo. Se o serviço não iniciar ou cair após pouco tempo - verifique seus logs para ver os erros.
4. Verifique a URL da API, ela pode estar especificada incorretamente em `./www/pro-ui/Config.js`. Se este for o caso, substitua a URL pela correta e recarregue a página.
5. Se todos os pontos acima estiverem ok - verifique o consumo de memória e confira novamente o arquivo de log da API. Talvez o serviço tenha ficado sem memória.

</details>

<details>

<summary>Banco de dados indisponível</summary>

A mensagem Banco de dados indisponível geralmente significa que os serviços Java não conseguem solicitar dados do banco de dados.

![DB unavailable](/files/616468fc5edea413b169e5362c21692e94441f66)

Comece por [verificar o status do MySQL](/docs/on-premise/pt-br/on-premise/how-to-guide/troubleshooting/checking-service-statuses.md#database). Se o MySQL estiver fora do ar - tente reiniciá‑lo e verifique seus logs para encontrar a causa da falha.

Se seu banco de dados estiver hospedado em um servidor separado, certifique-se de que a conexão com ele esteja disponível na porta padrão do MySQL 3306 (ou em uma porta personalizada se a instalação foi feita dessa forma - verifique o `db.properties` arquivo de qualquer um dos serviços Java).

</details>

<details>

<summary>Sua conexão não é privada</summary>

Esse erro informa que a conexão não está protegida por SSL.

![Sua conexão não é privada](/files/b1325c35d89cd57f2e98fbd56a5b1a6b221b589d)

Razões possíveis

* Você tenta acessar a porta 443 (com um link HTTPS) e não possui certificado SSL instalado.
* Seu certificado não cobre o nome de domínio que você está acessando.
* Seu certificado expirou e você precisa emitir um novo.
* Seu certificado não está configurado corretamente (não especificado na configuração do Nginx).

</details>

{% hint style="danger" %}
Se as informações acima não ajudarem a corrigir o problema, por favor entre em contato conosco em <support@navixy.com>, e descreva o problema em detalhes, fornecendo logs, arquivos de configuração e todas as outras informações valiosas que você tiver. Estamos sempre prontos para fornecer assistência abrangente.
{% endhint %}


---

# 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 dynamically by asking a question.

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

```
GET https://navixy.com/docs/on-premise/pt-br/on-premise/how-to-guide/troubleshooting/web-interface.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
