> ## 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.

# Importar/Exportar as Configurações

> Leva as configurações do painel de um servidor para outro, em um arquivo. Serve para montar um servidor novo com os mesmos ajustes, e não para mover sites, contas ou dados de…

**Caminho no painel:** menu da esquerda > Configuração > cartão **Painel de
Controle** > **Importar/Exportar as Configurações**

![Tela de importação e exportação, com o botão Download e as seis caixas de escopo de importação](https://mintcdn.com/san-internet/dZE3NBY61yDby7Jw/keyhelp-admin/imagens/controle-importar-exportar.png?fit=max\&auto=format\&n=dZE3NBY61yDby7Jw\&q=85\&s=bb63e591157404f560f5375c84f90348)

## Exportar

Em **Criar arquivo de exportação**, clique em **Download**.

**Conferido:** o arquivo é **JSON legível**, chamado
`keyhelp_settings_<data>.json`. Nesta instalação saiu com **258 KB**, e a maior
parte disso, 162 KB, são as imagens do White Label, gravadas dentro do próprio
arquivo.

O conteúdo tem seis partes:

| Parte | O que carrega |
| - | - |
| `meta` | a versão do painel e a data da exportação |
| `settings` | **186 ajustes** do painel |
| `databases` | as chaves de API, modelos de conta, White Label, notificações e botões personalizados |
| `white_label_images` | as imagens da identidade visual |
| `smtp` | a configuração de SMTP externo, quando houver |
| `email_design` | o modelo visual dos e-mails |

> [!WARNING]
>
> **O arquivo de exportação carrega as chaves de API para dentro**
>
> Conferido abrindo o arquivo: a parte `databases` traz a linha de cada chave de
> API, com o nome, os IPs autorizados, as datas e o **resumo criptográfico da
> chave**. O segredo em si não vai (ele não existe em lugar nenhum depois de
> criado), mas o resumo vai, e importar esse arquivo em outro servidor faz a
> chave antiga passar a valer lá.
>
> Some com isso: o arquivo exportado tem o mesmo valor de um cofre de acesso, e
> merece o mesmo cuidado. Não é anexo de e-mail, não é arquivo de pasta
> compartilhada aberta, e não sobra em pasta de downloads.

> [!WARNING]
>
> **A senha da interface do Rspamd também está lá dentro**
>
> Conferido procurando por nome de campo no arquivo: existe um
> `email.rspamd_web_ui_password`, com 126 caracteres, dentro de `settings`. É a
> senha da interface web do filtro de spam, e ela sai no arquivo mesmo com o
> escopo de importação não citando o assunto em lugar nenhum.
>
> Duas coisas seguem daí: o arquivo carrega mais do que as seis caixas de escopo
> sugerem, e quem o receber tem em mãos credencial de um serviço do servidor.

**Também vai para dentro do arquivo** o que identifica o servidor: nome de host,
endereço do painel, IPs de DNS e o endereço de e-mail do sistema.

**A chave de licença não vai.** Conferido: procurando por nome de campo no arquivo
inteiro, não existe nenhum campo de licença. Faz sentido, porque a licença é
amarrada ao hardware daquele servidor.

> [!NOTE]
>
> **Com SMTP externo, trate o arquivo como se a senha dele estivesse lá**
>
> A própria tela diz que o endereço de remetente só é importado se o arquivo
> contiver configurações de SMTP personalizadas: essas configurações viajam no
> arquivo, na parte `smtp`, e a senha do servidor externo pode ir junto.

## Importar

1. Clique em **Escolher arquivo** e selecione um arquivo exportado.
2. Marque, em **Escopo de importação**, o que você quer trazer.
3. Clique em **Iniciar processo de importação**.

O escopo tem seis caixas, e **Selecionar todos** marca todas de uma vez:

| Escopo | O que traz |
| - | - |
| **Configurações de API** | todas as chaves de API e os ajustes da API |
| **Pacotes de contas** | os modelos de conta |
| **Configurações de notificações** | o modelo visual dos e-mails, os textos personalizados, os ajustes relacionados e as configurações de webhook. O endereço do remetente vem junto somente se o arquivo trouxer SMTP personalizado |
| **Configurações do white label** | a identidade visual |
| **Botões personalizados** | os botões da edição profissional |
| **Página padrão do domínio** | o modelo da página inicial de domínio novo |

> [!WARNING]
>
> **A importação substitui, não soma, e apaga em silêncio o que não estiver no arquivo**
>
> **Medido**, em três passos: exportei o servidor, **depois** criei uma chave de
> API nova, e então importei aquele arquivo antigo com o escopo **Configurações de
> API** marcado. A chave criada depois da exportação **sumiu**. Sobrou a que
> estava no arquivo, com o mesmo identificador e as mesmas datas.
>
> **E o histórico não conta isso.** O painel registrou a criação da chave e
> registrou que as configurações de API foram importadas, e **não registrou a
> exclusão**. Quem for procurar depois por que a integração parou não acha o
> motivo no histórico.
>
> Um escopo marcado por engano troca a configuração daquele assunto inteiro. Vale
> exportar o servidor de destino **antes** de importar qualquer coisa nele, porque
> esse arquivo é o único caminho de volta que este painel oferece.

> [!WARNING]
>
> **O aviso sobre confiar na origem do arquivo é literal**
>
> A tela avisa para importar somente arquivos de fontes em que você confia. O
> motivo fica claro pelo conteúdo: um arquivo preparado por outra pessoa pode
> trazer **chave de API** e **identidade visual** para dentro do seu servidor.
> Uma chave de API importada é acesso de programa ao servidor inteiro.

## A regra da versão

A tela avisa que o arquivo **só pode ser importado num painel da mesma versão**
que o gerou. É por isso que `meta` guarda a versão.

**Conferido:** com o número de versão trocado dentro do arquivo, a importação foi
recusada com a mensagem de que o arquivo carregado não é compatível com o sistema
de importação, e nada foi alterado. A checagem é de verdade, e não um aviso de
tela.

Na prática isso muda a ordem do trabalho numa migração: atualizar os dois
servidores para a mesma versão **antes** de exportar, e não exportar de um
servidor velho para importar num novo.

## O que não vai no arquivo

Vale dizer o que a tela não promete, porque o nome sugere mais do que ela faz:

* contas de cliente, domínios, e-mails, bancos de dados e arquivos de site
* certificados de SSL/TLS
* as versões do PHP instaladas
* as tarefas agendadas

Isso é configuração do painel, não conteúdo do servidor. Mover um servidor
inteiro é outro assunto.

## O que pode dar errado

| Sintoma | Causa | O que fazer |
| - | - | - |
| **A importação é recusada** | o arquivo foi criado numa versão diferente do painel | igualar as versões dos dois servidores e exportar de novo |
| **Importei e perdi configuração que eu tinha** | a importação substitui o escopo inteiro | restaurar a partir da exportação feita antes. Se não houver, é refazer à mão |
| **Apareceu chave de API que eu não criei** | ela veio junto com o escopo de API do arquivo importado | conferir a lista em [API](/keyhelp-admin/api) e excluir o que não for seu |
| **Sumiu uma chave de API depois de uma importação, e o histórico não explica** | o escopo de API substitui a lista inteira, e apaga sem registrar o que não estava no arquivo | criar a chave de novo, e reexportar o servidor antes da próxima importação |
| O arquivo exportado ficou grande | as imagens do White Label vão dentro dele | é o esperado |

## Ver também

* [API](/keyhelp-admin/api), cujas chaves entram e saem neste arquivo
* [Notificações](/keyhelp-admin/notificacoes), um dos escopos de importação
* [Gerenciamento da Licença](/keyhelp-admin/gerenciamento-da-licenca), que **não** viaja no arquivo, porque é amarrada ao hardware


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