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

# Criar um backup

> Faz um backup na hora, do servidor inteiro ou de uma parte escolhida, num repositório que já existe.

**Caminho no painel:** menu da esquerda > **CONFIGURAÇÕES** > **Backup** > **Criar
backup**

Sem repositório não há onde guardar a cópia. Se ainda não existe um, comece por
[Adicionar um repositório](/keyhelp-admin/adicionar-repositorio).

![Formulário Criar backup: Âmbito do backup com Completo marcado, Repositório, Descrição, Endereço de email para notificações e a caixa de aviso em caso de sucesso](https://mintcdn.com/san-internet/dZE3NBY61yDby7Jw/keyhelp-admin/imagens/backup-criar.png?fit=max\&auto=format\&n=dZE3NBY61yDby7Jw\&q=85\&s=6fd1aa55ec27dd9bec0294d43cdc9746)

1. Em **Âmbito do backup**, escolha **Completo** ou **Customizado**.
2. Em **Repositório**, escolha onde guardar a cópia.
3. Em **Descrição**, escreva um texto que identifique este backup, se quiser.
4. Em **Endereço de email para notificações**, escreva o endereço que recebe o
   aviso, se quiser.
5. Clique em **Salvar**.

O painel responde *"Operação de backup criada."* e volta para a tela
[Backup](/keyhelp-admin/backup), com o pedido na lista **Últimos eventos** como **Inicia em
breve**. Ele começa na virada do minuto seguinte.

## Completo

O painel descreve o que entra:

> Cria um backup dos seguintes elementos: Painel de controle: Faz o backup do
> painel de controle, de suas ferramentas e bancos de dados e do banco de dados
> mysql. Configuração do sistema: Backup dos diretórios /etc/, /root/ e
> /var/spool/cron/. Contas de clientes: Backup de todas as contas de usuário, seus
> e-mails, bancos de dados e diretórios pessoais.

Ficam de fora as pastas temporárias das contas, `/home/users/*/tmp/`.

**Medido num backup completo:** entraram todas as contas de e-mail do servidor;
os bancos das contas de clientes e os do próprio painel (o `keyhelp`, os dois do
webmail, o do phpMyAdmin e o `mysql`); e as pastas `/etc/`, `/root/`,
`/var/spool/cron/`, `/home/keyhelp` e a pasta de cada conta de cliente.

## Customizado

![Opção Customizado aberta: Painel de controle, Configuração do sistema, Contas de clientes com a lista de contas e os três itens, Arquivos e diretórios, Excluir arquivos e diretórios e Todos os bancos de dados adicionais](https://mintcdn.com/san-internet/dZE3NBY61yDby7Jw/keyhelp-admin/imagens/backup-criar-customizado.png?fit=max\&auto=format\&n=dZE3NBY61yDby7Jw\&q=85\&s=c387e1e3159562ff6026a67a3fc22284)

| Opção | O que entra |
| - | - |
| **Painel de controle** | o que a descrição do **Completo** chama pelo mesmo nome: o painel, as ferramentas dele e os bancos dele |
| **Configuração do sistema** | pela mesma descrição, `/etc/`, `/root/` e `/var/spool/cron/` |
| **Contas de clientes** | abre uma lista e três itens: **Contas de e-mail**, **Banco de dados** e **Diretórios iniciais**. A lista escolhe **Todas as contas de usuário**, **Todas as contas de usuário a seguir** ou **Todos, exceto as seguintes contas de usuário**; as duas últimas abrem um campo para os nomes de usuário |
| **Arquivos e diretórios** | os caminhos escritos no campo que abre. A tela diz que o `*` vale como curinga |
| **Excluir arquivos e diretórios** | os caminhos que ficam de fora. Ver o aviso abaixo |
| **Todos os bancos de dados adicionais** | os bancos que não pertencem a nenhuma conta do painel. Medido: entrou um banco criado direto no servidor de banco de dados, e também o `sys`, que é do próprio MariaDB |

O painel recusa, com estas mensagens:

| Situação | Mensagem |
| - | - |
| nenhum repositório escolhido | *"Por favor selecione um repositório."* |
| **Contas de clientes** sem nenhum dos três itens marcado | *"Não foi especificado quais elementos das contas de usuário devem ser copiados."* |
| lista de contas escolhida e campo de nomes vazio | *"A lista de nomes de usuário está vazia."* |
| nome de usuário que não existe | *"O nome de usuário `<nome>` não existe."* |

> [!WARNING]
>
> **Um backup vazio é aceito, e termina como Concluído**
>
> Medido em três casos: **Customizado** sem nenhuma opção marcada; **Arquivos e
> diretórios** marcado com o campo vazio; e um caminho que não existe no servidor.
> Os três responderam *"Operação de backup criada."*, terminaram como
> **Concluído**, sem mensagem nenhuma, e criaram um snapshot de menos de 1 KB. O
> tamanho aparece na coluna **TAMANHO APÓS RESTAURAÇÃO**, em
> [Restaurar um backup](/keyhelp-admin/restaurar-backup).

> [!WARNING]
>
> **A exclusão só funciona com o caminho completo**
>
> Medido: em **Excluir arquivos e diretórios**, `*.log` foi gravado pelo painel
> como `/*.log`, com uma barra na frente. Assim ele só pega arquivos `.log` na raiz
> do servidor, e os `.log` da pasta escolhida entraram no backup. Com o caminho
> inteiro, `/home/users/<conta>/www/<pasta>/*.log`, eles ficaram de fora.

## Aviso por e-mail

| Campo | Vem com | O que faz |
| - | - | - |
| **Endereço de email para notificações** | vazio | o endereço que recebe o aviso. **Vazio, nenhum aviso sai**, nem de erro: medido com um backup concluído e com um cancelado |
| **Enviar notificação também em caso de sucesso** | marcado | desmarcado, o aviso sai só quando a operação falha |

**Medido com o endereço preenchido:** o aviso chegou no fim da operação.

| Resultado | Assunto do e-mail |
| - | - |
| sucesso | *"\[SUCESSO] Backup no servidor `<servidor>` \| Repositório: `<nome>` (Local)"* |
| erro | *"\[ERRO] Backup no servidor `<servidor>` \| Repositório: `<nome>` (Local)"* |

* O corpo diz o status, o servidor, o tipo de backup, o repositório e as mensagens registradas.
* **No aviso de erro, a mensagem vem do programa de backup, em inglês.**
* O e-mail sai com o [design de e-mail](/keyhelp-admin/modelos-de-design-de-e-mail) do servidor, que de fábrica tem o rodapé **KeyHelp Control Panel** e duas linhas em inglês.
* É o aviso *"Uma operação de backup foi concluída"*, da tela [Notificações](/keyhelp-admin/notificacoes), onde o texto se personaliza.

## O que pode dar errado

| Sintoma | Causa | O que fazer |
| - | - | - |
| **O backup terminou em segundos e o snapshot tem poucos bytes** | **Customizado** sem opção marcada, campo de caminhos vazio, ou caminho que não existe | conferir o âmbito e os caminhos, e fazer de novo |
| **Arquivos que deviam ficar de fora entraram no backup** | a exclusão foi escrita sem o caminho completo | escrever o caminho inteiro, começando por `/` |
| Nenhum e-mail chegou | o campo de endereço ficou vazio | preencher o endereço no próximo backup |
| O backup ficou como **Cancelado** | a operação encontrou um erro | abrir **Mensagens**, em [Backup](/keyhelp-admin/backup) |

## Ver também

* [Agendar backups regulares](/keyhelp-admin/agendar-backups-regulares), o mesmo formulário com dia e hora
* [Restaurar um backup](/keyhelp-admin/restaurar-backup), para trazer os dados de volta
* [Backup](/keyhelp-admin/backup), a lista de eventos onde o pedido aparece


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