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

# Petto Vault

> Faça cópias da estrutura do seu servidor (cargos, canais, permissões, emojis e configurações), agende cópias automáticas e restaure com segurança e uma prévia.

O Petto Vault é um lugar privado para proteger a configuração do seu servidor. Um backup é uma foto da **estrutura** do servidor: cargos, canais, permissões, emojis, figurinhas, regras do AutoMod e as principais configurações do servidor. Ele nunca guarda mensagens, lista de membros, tokens ou senhas.

> [!NOTE]
>
> Os backups podem ser colocados **em manutenção** pela equipe do Petto. Enquanto estiverem, o `!backup`, o seu menu e a página Backups do dashboard avisam, e os backups agendados não são feitos. Os backups que você já tem e o seu agendamento continuam como estão.

> [!NOTE]
>
> Os backups automáticos ficam **desligados** até um administrador ligá-los. Qualquer backup pode ser apagado a qualquer momento, e os backups de um servidor de onde o Petto saiu são apagados 30 dias depois do último.

![kira digita !backup e o Petto responde que os backups estão em manutenção e que os salvos são mantidos](https://mintcdn.com/wikipetto/-NPyec-GdEakT1iK/images/discord/guides/pt-br/petto-vault-maintenance.webp?fit=max\&auto=format\&n=-NPyec-GdEakT1iK\&q=85\&s=91f212c6aa262cf275afcc370b43adfa)

No Discord: enquanto os backups estão em manutenção, !backup avisa e não faz mais nada.

![A página Backups coberta pelo aviso Os backups estão em manutenção](https://mintcdn.com/wikipetto/tnepcXIgsoo8sThu/images/dashboard/guides/pt-br/petto-vault-dashboard-maintenance.webp?fit=max\&auto=format\&n=tnepcXIgsoo8sThu\&q=85\&s=6a45abda8777d8706f3e2f78d11923c2)

Dashboard → Backups: o mesmo aviso no dashboard.

## O que um backup guarda

* **Cargos**: nome, cor, ícone, permissões, posição, e se são exibidos separadamente ou podem ser mencionados.
* **Canais e categorias**: nomes, ordem, tópicos, modo lento, configurações de voz, tags e padrões de fóruns, e as permissões de cada um.
* **Emojis e figurinhas** (as figurinhas animadas Lottie não podem ser enviadas de novo, então uma restauração as pula).
* **Regras do AutoMod** do Discord, com suas exceções e ações.
* **Configurações do servidor**: nome, ícone e banner, descrição, idioma, nível de verificação, notificações, opções do canal do sistema e os canais especiais (regras, atualizações, AFK, alertas de segurança).

As únicas pessoas em um backup são as citadas nas permissões de um canal (o ID delas), que é o que uma restauração precisa para colocar essas permissões de volta.

## Comandos

### Abra o menu

```text theme={null}
!backup panel
```

O menu permite criar, listar, exportar, restaurar, apagar e agendar backups, e ver a atividade, a partir de uma lista de opções. É o que abre se você digitar só `!backup` (`!backups` e `!serverbackup` também funcionam).

![O painel do Petto Vault com três backups recentes, um agendamento a cada 24 horas guardando 7, e o menu para criar, listar, exportar, restaurar, apagar e agendar](https://mintcdn.com/wikipetto/-NPyec-GdEakT1iK/images/discord/guides/pt-br/backup.webp?fit=max\&auto=format\&n=-NPyec-GdEakT1iK\&q=85\&s=2ddf64fe716dcf7d5e96dbab7dc15e11)

No Discord: a Central de backups do !backup panel.

![A central de backups com o menu aberto: criar, listar, exportar o último, restaurar, apagar, agendar e a atividade](https://mintcdn.com/wikipetto/-NPyec-GdEakT1iK/images/discord/guides/pt-br/petto-vault-menu.webp?fit=max\&auto=format\&n=-NPyec-GdEakT1iK\&q=85\&s=41aa134fa71e573a85314b6f9a51d50c)

No Discord: o menu de !backup panel, aberto.

### Criar, listar e exportar

```text theme={null}
!backup create [name]
!backup list
!backup export [id]
```

> [accordion] !backup create
>
> ![liam cria um backup chamado Antes de mudar os cargos e o Petto diz que o backup 8 foi salvo com 14 cargos, 25 canais e 3 emojis](https://mintcdn.com/wikipetto/-NPyec-GdEakT1iK/images/discord/guides/pt-br/petto-vault-create.webp?fit=max\&auto=format\&n=-NPyec-GdEakT1iK\&q=85\&s=7146a3b1f5fd2acf4eab3eb5fbd8f797)
>
> No Discord: !backup create com um nome: o número e o que foi salvo.

> [accordion] !backup list
>
> ![O Petto lista os backups 7, 6 e 5 com seus nomes e há quanto tempo foram feitos](https://mintcdn.com/wikipetto/-NPyec-GdEakT1iK/images/discord/guides/pt-br/petto-vault-list.webp?fit=max\&auto=format\&n=-NPyec-GdEakT1iK\&q=85\&s=1a6e170351f0dfbce345f2162246e767)
>
> No Discord: !backup list: número, nome, automático ou manual, e quando.

> [accordion] !backup export
>
> ![O Petto diz que o backup 6 está pronto e anexa o arquivo petto-backup-1290000000000000001-6.json](https://mintcdn.com/wikipetto/-NPyec-GdEakT1iK/images/discord/guides/pt-br/petto-vault-export.webp?fit=max\&auto=format\&n=-NPyec-GdEakT1iK\&q=85\&s=e5e8521b6d4bf4579b5635fc85721855)
>
> No Discord: !backup export: o backup como arquivo JSON.

`export` entrega um arquivo JSON com a configuração capturada.

### Restaurar um backup

```text theme={null}
!backup restore <id> [mode]
```

Só **Administradores** podem restaurar. Nada muda até você confirmar, e uma restauração passa por etapas:

![shi usa !backup restore 6 e o Petto responde em vermelho que só Administradores podem restaurar](https://mintcdn.com/wikipetto/-NPyec-GdEakT1iK/images/discord/guides/pt-br/petto-vault-restore-admin-only.webp?fit=max\&auto=format\&n=-NPyec-GdEakT1iK\&q=85\&s=53ed40daf64edc59b6bcf0577f6471e6)

No Discord: um membro sem Administrador não pode restaurar.

1. **Prévia.** O Petto mostra quantos cargos, canais e emojis criaria ou atualizaria e, no modo `replace`, os **nomes dos canais e cargos que apagaria**.
2. **Verificação humana.** Uma imagem com letras, como a da verificação. Digite as letras para continuar.
3. **Backup de segurança.** O Petto salva o servidor como está agora, para você poder voltar. O número dele aparece no final.
4. **Progresso ao vivo.** Uma mensagem mostra a fase e quanto falta, com um botão **Parar restauração**. Só uma restauração roda por vez em um servidor.

> [accordion] 1. Prévia (merge)
>
> ![O Petto mostra o plano de restaurar o backup 6 no modo merge, com Continuar e Cancelar](https://mintcdn.com/wikipetto/-NPyec-GdEakT1iK/images/discord/guides/pt-br/petto-vault-restore-preview.webp?fit=max\&auto=format\&n=-NPyec-GdEakT1iK\&q=85\&s=e034b5f770c78eec2ef23e129e27cabb)
>
> No Discord: a prévia de um merge: o que seria criado e atualizado, nada é apagado.

> [accordion] 1. Prévia (replace)
>
> ![O Petto avisa em vermelho que replace apagaria os canais zona-spam e eventos-antigos e o cargo Temporário](https://mintcdn.com/wikipetto/-NPyec-GdEakT1iK/images/discord/guides/pt-br/petto-vault-restore-replace.webp?fit=max\&auto=format\&n=-NPyec-GdEakT1iK\&q=85\&s=c9cbc51495340b0c367cb50a2e8fd187)
>
> No Discord: no modo replace a prévia diz o que seria apagado.

> [accordion] 2. Verificação humana
>
> ![O cartão pede para digitar as letras da imagem, mostra K7M2Q e tem os botões para digitar, pedir outra imagem ou cancelar](https://mintcdn.com/wikipetto/-NPyec-GdEakT1iK/images/discord/guides/pt-br/petto-vault-restore-check.webp?fit=max\&auto=format\&n=-NPyec-GdEakT1iK\&q=85\&s=f63e55eb93fa7be5a8ba2b471c6f13fc)
>
> No Discord: depois de Continuar: a imagem com letras.
>
> ![A caixa de verificação humana com K7M2Q digitado](https://mintcdn.com/wikipetto/-NPyec-GdEakT1iK/images/discord/guides/pt-br/petto-vault-restore-modal.webp?fit=max\&auto=format\&n=-NPyec-GdEakT1iK\&q=85\&s=00eeec9ee2e7d7f12a32df550379e9c3)
>
> No Discord: a caixa onde as letras são digitadas.

> [accordion] 3 e 4. Backup de segurança e progresso ao vivo
>
> ![O cartão do Petto restaurando o backup 6 em 45%, passo 19 de 42, restaurando canais, com um botão vermelho para parar](https://mintcdn.com/wikipetto/-NPyec-GdEakT1iK/images/discord/guides/pt-br/petto-vault-restore-progress.webp?fit=max\&auto=format\&n=-NPyec-GdEakT1iK\&q=85\&s=1fc2e6f0877439b54d2c49be199dd051)
>
> No Discord: uma mensagem mostra a fase, quanto falta e Parar restauração.

> [accordion] O fim
>
> ![O Petto diz que o backup 6 foi restaurado no modo merge, que o backup de segurança é o 8 e o que foi criado e atualizado](https://mintcdn.com/wikipetto/-NPyec-GdEakT1iK/images/discord/guides/pt-br/petto-vault-restore-done.webp?fit=max\&auto=format\&n=-NPyec-GdEakT1iK\&q=85\&s=3c0b7b770f0b17ec79fb1d4a298e0fb5)
>
> No Discord: o fim da restauração, com o número do backup de segurança.

O `mode` pode ser:

* `merge` (o seguro): cria o que falta e atualiza o que existe. Não apaga nada.
* `replace`: também apaga os canais e cargos que não estão no backup.

> [!WARNING]
>
> Uma restauração parada mantém o que já fez e não apaga mais nada. O `replace` não apaga absolutamente nada se um cargo ou canal não pôde ser criado, e nunca apaga o canal de onde você começou nem os canais de regras, do sistema, de atualizações e AFK.

### Ative os backups automáticos

```text theme={null}
!backup schedule <hours> [keep]
```

![O Petto confirma backups automáticos a cada 24h, mantendo os 7 últimos, e quando roda o próximo](https://mintcdn.com/wikipetto/-NPyec-GdEakT1iK/images/discord/guides/pt-br/petto-vault-schedule.webp?fit=max\&auto=format\&n=-NPyec-GdEakT1iK\&q=85\&s=085f9c2c8e932f2a11f0507a0aee138a)

No Discord: !backup schedule 24 7: a cada 24 horas, mantendo 7.

`hours` vai de 1 a 168 e `keep` de 1 a 30 (7 se você não informar). Exemplo: `!backup schedule 24 7` faz um backup a cada 24 horas e mantém os últimos 7 automáticos. Para desligá-los:

```text theme={null}
!backup unschedule
```

![O Petto confirma que os backups automáticos estão desligados](https://mintcdn.com/wikipetto/-NPyec-GdEakT1iK/images/discord/guides/pt-br/petto-vault-unschedule.webp?fit=max\&auto=format\&n=-NPyec-GdEakT1iK\&q=85\&s=5fc42564808da7146adb0655a3825851)

No Discord: !backup unschedule.

### Apagar backups

```text theme={null}
!backup delete <id>
!backup delete --all true
```

Só **Administradores** podem apagar, e o Petto pede para você confirmar antes. Apagar todos os backups também desliga os automáticos. No menu é **Apagar backups** (digite um número, ou `ALL`).

> [accordion] !backup delete \<id>
>
> ![liam usa !backup delete 5 e o Petto pergunta em vermelho se apaga o backup 5, com Apagar e Cancelar](https://mintcdn.com/wikipetto/-NPyec-GdEakT1iK/images/discord/guides/pt-br/petto-vault-delete.webp?fit=max\&auto=format\&n=-NPyec-GdEakT1iK\&q=85\&s=583f60c236ed52c00d855fbbb63e4200)
>
> No Discord: o Petto pergunta antes de apagar um backup.
>
> ![A pergunta muda para Backup 5 apagado](https://mintcdn.com/wikipetto/-NPyec-GdEakT1iK/images/discord/guides/pt-br/petto-vault-delete-done.webp?fit=max\&auto=format\&n=-NPyec-GdEakT1iK\&q=85\&s=ade0f7e7db1328fed45a8896efaed7e6)
>
> No Discord: depois de Apagar.

> [accordion] !backup delete --all true
>
> ![O Petto pergunta em vermelho se apaga os 3 backups e desliga os automáticos](https://mintcdn.com/wikipetto/-NPyec-GdEakT1iK/images/discord/guides/pt-br/petto-vault-delete-all.webp?fit=max\&auto=format\&n=-NPyec-GdEakT1iK\&q=85\&s=cb5da730d9c825bc481b8f5ed4cf39dc)
>
> No Discord: apagar todos os backups também desliga os automáticos.

> [accordion] Apagar backups (menu)
>
> ![A caixa Apagar backups com 5 digitado no campo do número do backup ou ALL](https://mintcdn.com/wikipetto/-NPyec-GdEakT1iK/images/discord/guides/pt-br/petto-vault-delete-modal.webp?fit=max\&auto=format\&n=-NPyec-GdEakT1iK\&q=85\&s=ec3c41061113d13503a4d04084a3f33c)
>
> No Discord: no menu, Apagar backups pede um número ou ALL.

### Veja a atividade

```text theme={null}
!backup audit [limit]
```

Mostra quem criou, exportou, restaurou ou apagou backups e quem mudou o agendamento: as últimas 10 entradas, ou até 20 com `limit`.

![O Petto lista a atividade: uma exportação de liam, um backup agendado feito pelo Petto, um backup de liam e uma mudança de agendamento](https://mintcdn.com/wikipetto/-NPyec-GdEakT1iK/images/discord/guides/pt-br/petto-vault-audit.webp?fit=max\&auto=format\&n=-NPyec-GdEakT1iK\&q=85\&s=924df5cf3781bde253ded8aaba1581c6)

No Discord: !backup audit: quem fez o quê e quando.

## Use pelo dashboard

**Dashboard → Backups** faz o mesmo: criar, exportar, agendar, ver a atividade e apagar. **Restaurar** abre uma janela com as mesmas etapas (modo, o que trazer de volta, prévia, verificação humana) e depois mostra o progresso ao vivo com um botão **Parar restauração**.

![A página Backups com Criar um backup, Backups automáticos a cada 24 horas mantendo 7, três backups salvos, o cartão Seus dados e o histórico de atividade](https://mintcdn.com/wikipetto/tnepcXIgsoo8sThu/images/dashboard/guides/pt-br/petto-vault-dashboard.webp?fit=max\&auto=format\&n=tnepcXIgsoo8sThu\&q=85\&s=1699ebeb13b4d14da48d63148b3c9163)

Dashboard → Backups: criar, agendar, os backups salvos com Exportar, Restaurar e apagar, Seus dados e a atividade.

> [accordion] Prévia
>
> ![O diálogo de restauração com o conteúdo do backup 6, cargos, canais e emojis para criar e atualizar, e em vermelho os 2 canais e 1 cargo que apagaria](https://mintcdn.com/wikipetto/tnepcXIgsoo8sThu/images/dashboard/guides/pt-br/petto-vault-dashboard-preview.webp?fit=max\&auto=format\&n=tnepcXIgsoo8sThu\&q=85\&s=3346393815add67a8e3592578cf2d60b)
>
> Dashboard → Backups → Restaurar: o que o backup tem, o que seria criado e atualizado, e o que replace apagaria.

> [accordion] Verificação humana
>
> ![A etapa de verificação com a imagem K7M2Q, a resposta digitada e o botão Iniciar restauração](https://mintcdn.com/wikipetto/tnepcXIgsoo8sThu/images/dashboard/guides/pt-br/petto-vault-dashboard-check.webp?fit=max\&auto=format\&n=tnepcXIgsoo8sThu\&q=85\&s=68458d4bac2c4c8171cfbed54951faff)
>
> Dashboard → Backups → Restaurar: digite as letras da imagem e depois Iniciar restauração.

> [accordion] Progresso ao vivo
>
> ![Restaurando o backup 6 em 45%, passo 19 de 42, restaurando canais, com o botão para parar](https://mintcdn.com/wikipetto/tnepcXIgsoo8sThu/images/dashboard/guides/pt-br/petto-vault-dashboard-progress.webp?fit=max\&auto=format\&n=tnepcXIgsoo8sThu\&q=85\&s=1ba9f9b0a1385c8581dc29318475c7eb)
>
> Dashboard → Backups → Restaurar: o progresso da restauração, com Parar restauração.

> [accordion] O fim
>
> ![Restauração concluída, com o que foi criado, atualizado e apagado e a nota de que o backup 8 tem o servidor como era](https://mintcdn.com/wikipetto/tnepcXIgsoo8sThu/images/dashboard/guides/pt-br/petto-vault-dashboard-end.webp?fit=max\&auto=format\&n=tnepcXIgsoo8sThu\&q=85\&s=083eed67eabef7ba45ad78aa2f42b699)
>
> Dashboard → Backups → Restaurar: o fim, com o que mudou e o backup de segurança.

> [accordion] Apagar um backup
>
> ![O diálogo Apagar um backup perguntando se apaga o backup 5, com Cancelar e Apagar](https://mintcdn.com/wikipetto/tnepcXIgsoo8sThu/images/dashboard/guides/pt-br/petto-vault-dashboard-delete.webp?fit=max\&auto=format\&n=tnepcXIgsoo8sThu\&q=85\&s=cb24375e5f74e41a4bcfdcd8cadadd7b)
>
> Dashboard → Backups: apagar um backup pergunta antes.

### Restaurar só algumas partes

No dashboard você pode escolher **o que trazer de volta**. Desmarque o que deve ficar como está agora:

* **Cargos**
* **Canais, categorias e permissões**
* **Configurações do servidor**
* **Emojis**
* **Figurinhas**
* **Regras do AutoMod**

![A primeira etapa do diálogo de restauração: Merge ou Substituir, e as seis partes para recuperar, todas marcadas](https://mintcdn.com/wikipetto/tnepcXIgsoo8sThu/images/dashboard/guides/pt-br/petto-vault-dashboard-mode.webp?fit=max\&auto=format\&n=tnepcXIgsoo8sThu\&q=85\&s=bd3eb191c11436fd36701fb22cf16de0)

Dashboard → Backups → Restaurar: o modo e O que recuperar.

O `replace` só apaga dentro das partes que você traz de volta, então restaurar só os canais nunca apaga um cargo. A prévia também diz o que o backup contém: cargos, categorias, canais, permissões sobrescritas, emojis, figurinhas e regras do AutoMod.

> [!TIP]
>
> Restaurar só algumas partes é uma opção do dashboard. O `!backup restore` sempre traz de volta todas as partes.

O cartão **Seus dados** diz o que é guardado e permite desligar os backups automáticos ou apagar tudo.

O dashboard nunca fala direto com o banco de dados. As ações passam pelo bot, que confere no Discord se você tem `Manage Server` ou `Administrator` naquele servidor (restaurar e apagar precisam de `Administrator`).

## Banco de dados próprio

O Vault usa a sua própria conexão PostgreSQL através de `PETTO_VAULT_DATABASE_URL`. Defina a senha como uma variável privada no host e nunca a publique no repositório. O bot e o dashboard compartilham um segredo privado:

```env theme={null}
# Bot
PETTO_DASHBOARD_API_SECRET=a-long-random-secret

# Dashboard
PETTO_BOT_API_SECRET=a-long-random-secret
```


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