> ## Documentation Index
> Fetch the complete documentation index at: https://docs.saninternet.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Modo de Manutenção

> Fecha o painel de controle para todo mundo, menos para os endereços de IP que você listar. Serve para mexer no servidor ou na identidade visual sem cliente entrando no meio.

**Caminho no painel:** menu da esquerda > Configuração > cartão **Painel de
Controle** > **Modo de Manutenção**

![Tela do Modo de Manutenção, com a chave Ativado, a lista de IPs liberados e a nota sobre o console](https://mintcdn.com/san-internet/dZE3NBY61yDby7Jw/keyhelp-admin/imagens/controle-manutencao.png?fit=max\&auto=format\&n=dZE3NBY61yDby7Jw\&q=85\&s=964857c59ea818e8779dd8ea4c257512)

## O que ele fecha, e o que ele deixa aberto

**Conferido, com o modo ligado, de um endereço que não estava na lista:**

| Alvo | Antes | Com a manutenção ligada |
| - | - | - |
| **O painel de controle** | 200, a tela de entrada | **503**, a página de manutenção |
| Os sites hospedados dos clientes | respondendo | **respondendo igual** |
| O webmail | respondendo | **respondendo igual** |
| A API | recusa por falta de chave | **a mesma recusa por falta de chave** |

**Ele fecha o painel, e só o painel.** Site de cliente, webmail e API continuam de
pé. Para quem estava esperando "colocar o servidor em manutenção", isto é bem
menos do que o nome sugere, e é exatamente o que a descrição da tela promete.

A API merece uma frase própria: a chamada feita de um endereço **fora** da lista
respondeu com o erro de chave ausente, e não com o 503 da manutenção. Ou seja,
**a API não passa por esta porteira**, e uma integração continua mexendo no
servidor durante a manutenção.

## O que o visitante bloqueado vê

Uma página com o código **503**, dizendo que o painel de controle está
temporariamente indisponível por manutenção e pedindo que tente mais tarde.

**A identidade visual do White Label é aplicada nela.** O nome e o rodapé do
provedor aparecem normalmente.

**A página sai no idioma do navegador do visitante.** Medido com a manutenção
ligada:

| O navegador pede | A página veio em |
| - | - |
| português do Brasil | português |
| espanhol | espanhol |
| nenhum idioma, ou um que o painel não tem | o **idioma padrão** do servidor |

> [!NOTE]
>
> **Se a página aparecer em inglês, o culpado é o idioma padrão**
>
> O idioma padrão do servidor vem de fábrica em **inglês**, e é ele que atende o
> visitante cujo navegador não pede um idioma que o painel tenha. Para quem
> atende clientes no Brasil, vale pôr o padrão em português do Brasil, na tela
> [Idiomas](/keyhelp-admin/idiomas).

## Ligar

1. Marque **Ativado**.
2. Confira a caixa **IPs excluídos do modo manutenção**.
3. Clique em **Salvar**.

O painel confirma com duas mensagens, uma dizendo que as configurações foram
atualizadas e outra dizendo que o modo de manutenção está ativado, e essa segunda
continua aparecendo enquanto ele estiver ligado.

> [!NOTE]
>
> **O campo já vem com o seu IP escrito, e isso não quer dizer que ele esteja salvo**
>
> Medido: com o modo desligado e nada guardado no banco, a tela **já abre com o
> endereço de quem está olhando** preenchido no campo. É uma ajuda do painel, não
> uma configuração existente. Ela só vira configuração quando você clica em
> **Salvar**.

> [!WARNING]
>
> **Quem esvaziar a lista e salvar perde o caminho de volta pelo navegador**
>
> A própria tela avisa que é preciso incluir ao menos o seu próprio IP para
> conseguir desligar depois pelo navegador. Vale reforçar por que o risco é maior
> do que parece: em conexão doméstica ou móvel o endereço **muda sozinho**, sem
> você fazer nada. Ligar a manutenção à noite e voltar de manhã com outro IP é um
> cenário comum, não exótico.
>
> Quando a lista permite faixa, listar a faixa da sua operadora é mais seguro do
> que listar um endereço único.

## Se você ficar de fora

A tela indica o caminho: rodar `keyhelp-toolbox` no console do servidor, que tem
opção para desligar a manutenção.

> [!NOTE]
>
> **Esse caminho precisa de console, e o programa é de menu**
>
> `keyhelp-toolbox` abre um menu e espera escolha de uma pessoa. Quem administra o
> servidor precisa ter acesso ao console, seja por SSH ou pelo console do
> provedor, antes de precisar dele. Deixar isso testado **antes** de ligar a
> manutenção pela primeira vez evita descobrir na hora errada que o acesso não
> existia.

## Desligar

Desmarque **Ativado** e clique em **Salvar**. **Conferido:** o painel voltou a
responder 200 de fora na mesma hora, sem esperar o minuto de manutenção do
servidor.

A chave e a lista de IPs são dois ajustes separados no painel. Para deixar a lista
vazia, apague o conteúdo do campo antes de salvar: **conferido**, salvando com o
campo em branco, o que estava guardado foi embora.

## O que pode dar errado

| Sintoma | Causa | O que fazer |
| - | - | - |
| **Fiquei trancado fora do painel** | seu IP mudou depois de ligar a manutenção, ou não estava na lista | desligar pelo console, com `keyhelp-toolbox` |
| Liguei a manutenção e os sites dos clientes continuam no ar | é o comportamento correto, ele fecha só o painel | para tirar site do ar, o caminho é outro |
| **Liguei a manutenção e a integração continuou mexendo no servidor** | a API não passa pelo modo de manutenção | desligar o acesso em [API](/keyhelp-admin/api) durante a janela |
| O cliente diz que viu a mensagem em inglês | o navegador dele não pediu um idioma que o painel tenha, e o idioma padrão do servidor está em inglês | pôr o idioma padrão em português do Brasil, em [Idiomas](/keyhelp-admin/idiomas) |

## Ver também

* [API](/keyhelp-admin/api), que continua respondendo durante a manutenção
* [Acesso e Sessão](/keyhelp-admin/acesso-e-sessao), que também trabalha com restrição por IP, e com outra lógica
* [Tarefas agendadas](/keyhelp-admin/tarefas-agendadas), o que continua rodando enquanto o painel está fechado


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.