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

# Restaurar um backup

> Traz de volta, de um snapshot, arquivos e pastas, bancos de dados e contas de e-mail, para o lugar original ou para outro lugar.

**Caminho no painel:** menu da esquerda > **CONFIGURAÇÕES** > **Backup** >
**Restaurar backup**. O relógio verde da
[lista de repositórios](/keyhelp-admin/gerenciamento-de-repositorio) abre a mesma tela.

![Tela de restauração: o Repositório escolhido e a lista Snapshots, com a data do primeiro snapshot marcada](https://mintcdn.com/san-internet/dZE3NBY61yDby7Jw/keyhelp-admin/imagens/backup-restaurar-snapshots.png?fit=max\&auto=format\&n=dZE3NBY61yDby7Jw\&q=85\&s=17932bdaa41dc0cbf94f3c395bd695fc)

1. Em **Repositório**, escolha o repositório.
2. Na lista **Snapshots**, clique na data do snapshot que tem os dados, marcada na imagem.
3. Nas três partes da tela seguinte, marque o que deve voltar.
4. Clique em **Salvar**.

O painel responde *"Operação de backup foi criada."*, com a palavra backup mesmo
sendo uma restauração. A operação aparece na lista **Últimos eventos**, da tela
[Backup](/keyhelp-admin/backup), como **Restaurar backup**, e roda na virada do minuto
seguinte.

A lista de snapshots mostra, de cada um: **CRIADO EM**, **DESCRIÇÃO**, quantas
**CONTAS DE E-MAIL**, **BANCO DE DADOS** e **CAMINHOS** ele guarda, e o **TAMANHO
APÓS RESTAURAÇÃO**, o espaço que os dados ocupam fora do repositório.

## As três partes

A tela seguinte tem **Contas de e-mail**, **Banco de dados** e **Arquivos e
diretórios**. Cada parte tem um campo **Busca**, a lista do que o snapshot guarda,
e os atalhos *"Selecionar filtrado / Selecionar todos / Desmarcar todos"*. A parte
que o snapshot não tem mostra *"- Nenhuma entrada disponível -"*.

A tela avisa, nas duas primeiras partes:

> Os elementos devem existir para serem restaurados. Os elementos que não existem
> ficam acinzentados. Os elementos não existentes devem ser criados primeiro antes
> que seu conteúdo possa ser restaurado.

Uma conta de e-mail ou um banco que foi apagado precisa ser criado de novo, com o
mesmo nome, antes da restauração.

### Banco de dados

![Parte Banco de dados: a lista de bancos com um marcado, e a opção Restaurar banco de dados como arquivo .sql marcada, com o Local da restauração](https://mintcdn.com/san-internet/dZE3NBY61yDby7Jw/keyhelp-admin/imagens/backup-restaurar-bancos.png?fit=max\&auto=format\&n=dZE3NBY61yDby7Jw\&q=85\&s=f3d6e761c7f3a7ccb414309101f497eb)

**Restaurado no lugar original, o banco inteiro volta ao estado do snapshot.**
Medido com um banco criado para o teste: uma linha alterada depois do backup voltou
ao valor antigo, e **uma linha gravada depois do backup sumiu**.

> [!WARNING]
>
> **A lista traz os bancos do próprio painel**
>
> Entre os bancos aparece o `keyhelp`, que é o banco do painel, onde ficam as
> contas, os domínios e os ajustes. **Selecionar todos** marca também ele. A
> restauração no lugar original troca o banco inteiro pelo do snapshot, como
> medido acima, e no `keyhelp` isso alcança as contas, os domínios e os ajustes
> do painel. O mesmo vale para os bancos do webmail.

**Restaurar banco de dados como arquivo .sql** não mexe no banco. Com ela marcada,
o campo **Local da restauração** pede a pasta, em caminho completo. Medido: o banco
continuou igual, e apareceu na pasta um arquivo com o nome do banco e a extensão
`.sql`, com os comandos para criar o banco e as tabelas dele. A pasta não existia,
e foi criada.

A tela lembra que esta é também a saída para um banco que não existe mais:
*"Como alternativa, você pode restaurar elementos existentes e não existentes em
um local diferente, marcando primeiro a caixa de seleção Restaurar banco de dados
como arquivo .sql."*

### Arquivos e diretórios

![Parte Arquivos e diretórios: a lista de caminhos, a opção Restaurar um único arquivo ou subdiretório com o caminho preenchido, e o Local da restauração em Caminho alternativo](https://mintcdn.com/san-internet/dZE3NBY61yDby7Jw/keyhelp-admin/imagens/backup-restaurar-caminhos.png?fit=max\&auto=format\&n=dZE3NBY61yDby7Jw\&q=85\&s=0459dae1c23ee374be0293a0224866d7)

A lista mostra os caminhos que o snapshot guarda, como `/etc/` e a pasta de cada
conta. Marcar um caminho restaura tudo o que está dentro dele.

**Restaurar um único arquivo ou subdiretório** abre dois campos: à esquerda, o
caminho do snapshot; à direita, o resto do caminho até o arquivo ou a pasta. Na
imagem, o arquivo `www/index.html` da pasta de uma conta.

**Local da restauração** aparece quando há caminho marcado ou arquivo único
escolhido:

| Opção | Para onde vai |
| - | - |
| **Caminho original** | de volta ao lugar de onde saiu. Vem marcada |
| **Caminho alternativo** | para a pasta escrita no campo que abre, em caminho completo |

**Medido:**

| Teste | Resultado |
| - | - |
| arquivo apagado, restaurado sozinho no caminho original | voltou igual: mesmo conteúdo, dono, permissão e data de modificação |
| pasta restaurada no caminho original, com um arquivo alterado e outro criado depois do backup | **o alterado voltou à versão do backup, e o criado depois continuou lá** |
| pasta restaurada num caminho alternativo que não existia | o caminho foi criado, e a pasta foi para dentro dele, com o nome, o dono e as datas originais |

> [!WARNING]
>
> **O caminho original substitui os arquivos sem perguntar**
>
> A versão que está no servidor é trocada pela do snapshot, e o painel não pede
> confirmação. Para comparar antes de trocar, restaure num caminho alternativo.

## Apagar snapshots

1. Na lista **Snapshots**, marque os snapshots.
2. Em **Ações em massa**, escolha **Deletar snapshots** e clique em **Aplicar**.
3. Na janela *"Tem certeza de que deseja excluir os snapshots selecionados?"*, clique em **Sim**.

O painel responde *"Operação de exclusão de snapshot criada."* A operação aparece
como **Deletar snapshots**, seguida de uma verificação que mostra o repositório
diminuindo. **Medido: o espaço volta para o disco.** Apagados os snapshots de um
teste, a pasta do repositório voltou aos 64 MB que tinha antes deles.

## O que pode dar errado

| Sintoma | Causa | O que fazer |
| - | - | - |
| **Um arquivo que devia ser mantido foi trocado pela versão antiga** | a restauração no caminho original substitui sem perguntar | restaurar num caminho alternativo e copiar só o que for preciso |
| **Os dados gravados no banco depois do backup sumiram** | o banco restaurado volta inteiro ao estado do snapshot | restaurar como arquivo `.sql` e recuperar só o que faltar |
| Restaurei uma pasta e ficaram arquivos que não estavam no backup | a restauração não apaga o que foi criado depois | apagar à mão o que sobrou |
| Um item aparece cinza e não dá para marcar | ele não existe mais no servidor | criar de novo, com o mesmo nome, e restaurar |
| A parte mostra *"- Nenhuma entrada disponível -"* | o snapshot não guardou aquele tipo de dado | escolher outro snapshot |

## Ver também

* [Criar um backup](/keyhelp-admin/criar-backup), o que cada tipo de backup guarda
* [Gerenciamento de repositório](/keyhelp-admin/gerenciamento-de-repositorio), de onde se chega aqui pelo repositório
* [Backup](/keyhelp-admin/backup), a lista de eventos


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