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

# Adicionar um repositório

> Cria o lugar onde os backups ficam guardados: uma pasta do próprio servidor ou um serviço de armazenamento remoto. É o primeiro passo antes de qualquer backup.

**Caminho no painel:** menu da esquerda > **CONFIGURAÇÕES** > **Backup** >
**Gerenciamento de repositório** > **Adicionar repositório**

![Formulário Adicionar repositório: Nome, Senha, Confirme a senha, Sugestão de senha com o botão Gerar, Rotação de snapshot, Tipo de armazenamento Local e Diretório](https://mintcdn.com/san-internet/dZE3NBY61yDby7Jw/keyhelp-admin/imagens/backup-repositorio-adicionar.png?fit=max\&auto=format\&n=dZE3NBY61yDby7Jw\&q=85\&s=5fc2f7b84bbb55ec790448554307ea93)

1. Em **Nome**, escreva um nome para o repositório.
2. Ao lado de **Sugestão de senha**, clique em **Gerar**. A senha sugerida vai para **Senha** e **Confirme a senha**. Também dá para escrever uma senha nos dois campos.
3. Copie a senha e guarde-a fora do painel.
4. Em **Rotação de snapshot**, escolha se os snapshots antigos são apagados sozinhos.
5. Em **Tipo de armazenamento**, escolha o destino, e preencha os campos que ele abre.
6. Clique em **Salvar**.

O painel responde *"O repositório de backup `<nome>` foi adicionado."*, e o
repositório aparece na [lista de repositórios](/keyhelp-admin/gerenciamento-de-repositorio).
Medido com o tipo **Local**: a pasta foi criada e preparada no mesmo instante, e o
painel rodou em seguida uma verificação do repositório novo.

> [!WARNING]
>
> **A senha não tem recuperação**
>
> A tela avisa: *"Um repositório é sempre criptografado com uma senha. Por favor,
> mantenha esta senha em um lugar seguro, caso contrário, você não poderá mais
> acessar o repositório."* O painel guarda a senha para rodar os backups, mas
> quem precisar abrir o repositório em outro servidor, ou devolvê-lo ao painel
> depois de uma exclusão, precisa dela.

## Rotação de snapshot

![Rotação de snapshot em Por período, com snapshots diários, semanais e mensais marcados](https://mintcdn.com/san-internet/dZE3NBY61yDby7Jw/keyhelp-admin/imagens/backup-repositorio-rotacao.png?fit=max\&auto=format\&n=dZE3NBY61yDby7Jw\&q=85\&s=76fcc0eaf68f725273d381d4b165e895)

A tela explica: *"Cada execução de backup cria uma imagem dos seus dados
(snapshot), o que pode ocupar muito espaço de armazenamento com o passar do
tempo."*

| Opção | O que faz |
| - | - |
| **Desativado** | vem escolhida. Nenhum snapshot é apagado sozinho |
| **Por contagem** | abre **Número máximo de snapshots**. Medido com 2: depois do terceiro backup, o mais antigo foi apagado, e ficaram os dois mais novos |
| **Por período** | *"Manter os snapshots mais recentes no período selecionado"*: um número para cada período marcado, entre **diário**, **semanal**, **mensais** e **anual**. Medido com 1 diário: ficou só o backup mais recente do dia |

**A limpeza roda depois de cada backup, e também logo depois de salvar a
rotação**, e aparece na lista de eventos como **Eliminar repositório**. O nome
assusta, e o repositório continua: ver o aviso em [Backup](/keyhelp-admin/backup).

> [!WARNING]
>
> **Sem rotação, o repositório só cresce**
>
> Com **Desativado**, que é como o formulário vem, cada backup acrescenta um
> snapshot, e nenhum sai sozinho. Com backups agendados, o espaço do destino vai
> sendo ocupado sem aviso. Para apagar à mão, ver **Apagar snapshots** em
> [Restaurar um backup](/keyhelp-admin/restaurar-backup).

## Tipo de armazenamento

| Tipo | Campos que abre |
| - | - |
| **Local** | **Diretório**, uma pasta deste servidor. A tela pede: *"Caminho absoluto no sistema de arquivos local. Não use o diretório raiz e especifique pelo menos uma subpasta."* O campo vem com uma sugestão dentro de `/backup/` |
| **FTP(S)** | **Host**, **Porta**, **Nome de usuário**, **Senha**, **Criptografia** e **Diretório**. A criptografia vem em **FTP explícito sobre TLS**; as outras opções são **FTP implícito sobre TLS** e **FTP simples (não criptografado, não seguro)** |
| **SFTP** | **Host**, **Porta**, **Nome de usuário**, **Método de autenticação** (**Senha** ou **Pública / Chave Privada**) e **Diretório** |
| **WebDAV** | **URL WebDAV**, **Nome de usuário**, **Senha** e **Diretório** |
| **KeyDisc** | **Nome de usuário**, **Método de autenticação**, **Senha** e **Diretório**, este com `/files` fixo na frente. A tela não explica o que é o KeyDisc |
| **Dropbox** | **Código de acesso** e **Diretório**. O botão **Solicitar código de acesso** abre o login do Dropbox, e o código aparece depois de autorizar |
| **Customizado** | **Configuração de armazenamento personalizada**, uma configuração do Rclone, com **Exemplos de configuração** para SFTP e AWS S3, e **Diretório** |

Em **Porta**, a tela avisa: *"Se este campo estiver vazio, a porta padrão será
usada."*

**O FTP(S) tem dois campos a mais, escondidos.** O link **Configurações avançadas**,
embaixo do **Diretório**, abre:

| Campo | Como vem | O que é |
| - | - | - |
| **Não verificar o certificado TLS do servidor** | desmarcado | marcado, o painel deixa de conferir o certificado TLS do servidor de destino |
| **Conexões FTP simultâneas** | vazio, com mínimo de 2 | *"Determina o número máximo de conexões FTP simultâneas."* |

Os outros tipos não têm esse link.

### SFTP com chave, sem senha

No **SFTP**, o **Método de autenticação** **Pública / Chave Privada** troca a senha
por uma chave que o próprio painel cria.

1. Em **Método de autenticação**, escolha **Pública / Chave Privada**.
2. Clique em **Criar chave pública**. A chave aparece no campo **Chave pública**, com os botões **Copiar** e **Remover**.
3. Clique em **Copiar** e ponha a chave no servidor de destino, nas chaves autorizadas do usuário que vai receber os backups (o arquivo `~/.ssh/authorized_keys` dele). A tela pede: *"Coloque a chave pública no servidor remoto."*
4. Preencha **Host**, **Nome de usuário** e **Diretório**, e salve como nos outros tipos.

**Medido contra o próprio servidor**, com um usuário de teste que só entrava por
chave: o painel entrou com a chave, criou o repositório no diretório e rodou a
verificação. Um backup do diretório de uma conta de cliente foi concluído e deixou
1 snapshot de 35,88 KB.

A chave é RSA de 4096 bits, com o comentário `Generated-By-KeyHelp`. **A chave
privada fica com o painel**, guardada cifrada junto da configuração do repositório,
e quem cuida do destino só recebe a pública.

**Os destinos remotos passam pelo Rclone**, um programa de cópia para serviços de
armazenamento. A tela do tipo **Customizado** explica: *"Ao conectar a um
armazenamento remoto, o software Rclone é usado."* O aplicativo do Dropbox que o
painel usa se troca em [Backup (configuração)](/keyhelp-admin/config-backup).

## O que pode dar errado

| Sintoma | Causa | O que fazer |
| - | - | - |
| **O espaço do destino acabou** | a rotação está em **Desativado**, e os snapshots se acumulam | ligar a rotação, que já apaga os excedentes ao salvar |
| **O repositório entrou na lista com o triângulo vermelho** | no diretório já havia um repositório, com outra senha | ver [Gerenciamento de repositório](/keyhelp-admin/gerenciamento-de-repositorio), em **Voltar a usar um repositório excluído** |
| Não sei mais a senha do repositório | ela não foi guardada fora do painel | ver a linha da senha perdida em [Gerenciamento de repositório](/keyhelp-admin/gerenciamento-de-repositorio) |
| O SFTP com chave não conecta | a chave pública não está nas chaves autorizadas do usuário de destino | copiar a chave de novo com **Copiar** e conferir o arquivo `~/.ssh/authorized_keys` do usuário no destino |

## Ver também

* [Gerenciamento de repositório](/keyhelp-admin/gerenciamento-de-repositorio), para editar, sincronizar e excluir
* [Criar um backup](/keyhelp-admin/criar-backup), o passo seguinte
* [Backup (configuração)](/keyhelp-admin/config-backup), os repositórios que os clientes podem criar na própria conta


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