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

> Guarda copias de la estructura de tu servidor (roles, canales, permisos, emojis y ajustes), prográmalas de forma automática y restáuralas con seguridad y una vista previa.

Petto Vault es un lugar privado para proteger la configuración de tu servidor. Una copia de seguridad (backup) es una foto de la **estructura** del servidor: roles, canales, permisos, emojis, stickers, reglas de AutoMod y los ajustes principales del servidor. Nunca guarda mensajes, una lista de miembros, tokens ni contraseñas.

> [!NOTE]
>
> El equipo de Petto puede poner las copias de seguridad **en mantenimiento**. Mientras lo estén, `!backup`, su menú y la página Copias de seguridad del dashboard lo avisan, y las copias programadas no se hacen. Las copias que ya tienes y tu programación se mantienen como están.

> [!NOTE]
>
> Las copias automáticas están **apagadas** hasta que un administrador las active. Cualquier copia se puede borrar en cualquier momento, y las copias de un servidor del que salió Petto se borran 30 días después de la última.

![kira escribe !backup y Petto responde que los backups están en mantenimiento y que las copias guardadas se conservan](https://mintcdn.com/wikipetto/aURko5p8En80OELa/images/discord/guides/es/petto-vault-maintenance.webp?fit=max\&auto=format\&n=aURko5p8En80OELa\&q=85\&s=9bb1013ae6e5820ba4b01e64fdec7a92)

En Discord: mientras los backups están en mantenimiento, !backup lo dice y no hace nada más.

![La página de copias de seguridad cubierta por el aviso Los backups están en mantenimiento](https://mintcdn.com/wikipetto/-zl3RNr1X6pRGWW3/images/dashboard/guides/es/petto-vault-dashboard-maintenance.webp?fit=max\&auto=format\&n=-zl3RNr1X6pRGWW3\&q=85\&s=696c09764a31602d47fbfcbaa099662c)

Dashboard → Copias de seguridad: el mismo aviso en el dashboard.

## Qué guarda una copia

* **Roles**: nombre, color, ícono, permisos, posición, y si se muestran por separado o se pueden mencionar.
* **Canales y categorías**: nombres, orden, temas, modo lento, ajustes de voz, etiquetas y valores predeterminados de foros, y los permisos de cada uno.
* **Emojis y stickers** (los stickers animados Lottie no se pueden volver a subir, así que una restauración los salta).
* **Reglas de AutoMod** de Discord, con sus excepciones y acciones.
* **Ajustes del servidor**: nombre, ícono y banner, descripción, idioma, nivel de verificación, notificaciones, opciones del canal del sistema y los canales especiales (reglas, novedades, AFK, alertas de seguridad).

Las únicas personas que aparecen en una copia son las nombradas en los permisos de un canal (su ID), que es lo que una restauración necesita para devolver esos permisos.

## Comandos

### Abrir el menú

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

El menú te deja crear, listar, exportar, restaurar, borrar y programar copias, y revisar la actividad, desde una lista de opciones. Es lo que se abre si escribes solo `!backup` (`!backups` y `!serverbackup` también funcionan).

![El panel de Petto Vault con tres copias recientes, una programación cada 24 horas que guarda 7, y el menú para crear, listar, exportar, restaurar, borrar y programar](https://mintcdn.com/wikipetto/aURko5p8En80OELa/images/discord/guides/es/backup.webp?fit=max\&auto=format\&n=aURko5p8En80OELa\&q=85\&s=bae4eabbea61c8a375af86a7cdad5e62)

En Discord: el Centro de copias de !backup panel.

![El centro de copias con su menú abierto: crear, listar, exportar la última, restaurar, borrar, programar y la actividad](https://mintcdn.com/wikipetto/aURko5p8En80OELa/images/discord/guides/es/petto-vault-menu.webp?fit=max\&auto=format\&n=aURko5p8En80OELa\&q=85\&s=2c7b630eea4ae4dce7fce09b13578b67)

En Discord: el menú de !backup panel, abierto.

### Crear, listar y exportar

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

> [accordion] !backup create
>
> ![liam crea una copia llamada Antes de cambiar los roles y Petto dice que se guardó la copia 8 con 14 roles, 25 canales y 3 emojis](https://mintcdn.com/wikipetto/aURko5p8En80OELa/images/discord/guides/es/petto-vault-create.webp?fit=max\&auto=format\&n=aURko5p8En80OELa\&q=85\&s=105658dd19de0842d27042158be2cc57)
>
> En Discord: !backup create con un nombre: el número y lo que se guardó.

> [accordion] !backup list
>
> ![Petto lista las copias 7, 6 y 5 con sus nombres y hace cuánto se hicieron](https://mintcdn.com/wikipetto/aURko5p8En80OELa/images/discord/guides/es/petto-vault-list.webp?fit=max\&auto=format\&n=aURko5p8En80OELa\&q=85\&s=4c8de7e99abd18abadb3d15d953a318b)
>
> En Discord: !backup list: número, nombre, automática o manual, y cuándo.

> [accordion] !backup export
>
> ![Petto dice que la copia 6 está lista y adjunta el archivo petto-backup-1290000000000000001-6.json](https://mintcdn.com/wikipetto/aURko5p8En80OELa/images/discord/guides/es/petto-vault-export.webp?fit=max\&auto=format\&n=aURko5p8En80OELa\&q=85\&s=10fffeb698709cd622a46d7643dd6450)
>
> En Discord: !backup export: la copia como archivo JSON.

`export` te da un archivo JSON con la configuración guardada.

### Restaurar una copia

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

Solo los **administradores** pueden restaurar. No cambia nada hasta que confirmes, y una restauración pasa por pasos:

![shi usa !backup restore 6 y Petto responde en rojo que solo los Administradores pueden restaurar](https://mintcdn.com/wikipetto/aURko5p8En80OELa/images/discord/guides/es/petto-vault-restore-admin-only.webp?fit=max\&auto=format\&n=aURko5p8En80OELa\&q=85\&s=9868dea3512a1ad336715cb4148c735e)

En Discord: un miembro sin Administrador no puede restaurar.

1. **Vista previa.** Petto muestra cuántos roles, canales y emojis crearía o actualizaría y, en modo `replace`, los **nombres de los canales y roles que borraría**.
2. **Verificación humana.** Una imagen con letras, como la de la verificación. Escribe las letras para continuar.
3. **Copia de seguridad previa.** Petto guarda el servidor tal como está en ese momento, para que puedas volver atrás. Su número se muestra al final.
4. **Progreso en vivo.** Un mensaje muestra la fase y cuánto falta, con un botón **Detener restauración**. Solo puede correr una restauración a la vez en un servidor.

> [accordion] 1. Vista previa (merge)
>
> ![Petto muestra el plan de restaurar la copia 6 en modo merge, con Continuar y Cancelar](https://mintcdn.com/wikipetto/aURko5p8En80OELa/images/discord/guides/es/petto-vault-restore-preview.webp?fit=max\&auto=format\&n=aURko5p8En80OELa\&q=85\&s=3dd65f39eaace3f059f6336def09e6a2)
>
> En Discord: la vista previa de un merge: lo que se crearía y actualizaría, nada se borra.

> [accordion] 1. Vista previa (replace)
>
> ![Petto avisa en rojo que replace borraría los canales zona-spam y eventos-viejos y el rol Temporal](https://mintcdn.com/wikipetto/aURko5p8En80OELa/images/discord/guides/es/petto-vault-restore-replace.webp?fit=max\&auto=format\&n=aURko5p8En80OELa\&q=85\&s=9da03a59a3413791115a4baae3b48456)
>
> En Discord: en modo replace la vista previa nombra lo que se borraría.

> [accordion] 2. Comprobación humana
>
> ![La tarjeta pide escribir las letras de la imagen, muestra K7M2Q y tiene los botones para escribirlas, pedir otra imagen o cancelar](https://mintcdn.com/wikipetto/aURko5p8En80OELa/images/discord/guides/es/petto-vault-restore-check.webp?fit=max\&auto=format\&n=aURko5p8En80OELa\&q=85\&s=8ad35d6dc4c0b2893376a24d3e993e5f)
>
> En Discord: después de Continuar: la imagen con letras.
>
> ![El cuadro de comprobación humana con K7M2Q escrito](https://mintcdn.com/wikipetto/aURko5p8En80OELa/images/discord/guides/es/petto-vault-restore-modal.webp?fit=max\&auto=format\&n=aURko5p8En80OELa\&q=85\&s=07cbc14320160751e22eb10b84b955a9)
>
> En Discord: el cuadro donde se escriben las letras.

> [accordion] 3 y 4. Copia de seguridad previa y progreso en vivo
>
> ![La tarjeta de Petto restaurando la copia 6 al 45%, paso 19 de 42, restaurando canales, con un botón rojo para detener](https://mintcdn.com/wikipetto/aURko5p8En80OELa/images/discord/guides/es/petto-vault-restore-progress.webp?fit=max\&auto=format\&n=aURko5p8En80OELa\&q=85\&s=baac746a41813d4978822bae08e4ba93)
>
> En Discord: un mensaje muestra la fase, cuánto falta y Detener restauración.

> [accordion] El final
>
> ![Petto dice que la copia 6 se restauró en modo merge, que la copia previa es la 8 y lo que se creó y actualizó](https://mintcdn.com/wikipetto/aURko5p8En80OELa/images/discord/guides/es/petto-vault-restore-done.webp?fit=max\&auto=format\&n=aURko5p8En80OELa\&q=85\&s=35426b0ce5ddce1bf4a6ecc0b122352e)
>
> En Discord: el final de la restauración, con el número de la copia de seguridad previa.

El `mode` puede ser:

* `merge` (el seguro): crea lo que falta y actualiza lo que existe. No borra nada.
* `replace`: además borra los canales y roles que no están en la copia.

> [!WARNING]
>
> Una restauración detenida conserva lo que ya hizo y no borra nada más. `replace` no borra absolutamente nada si no se pudo crear un rol o un canal, y nunca borra el canal desde donde la iniciaste ni los canales de reglas, sistema, novedades y AFK.

### Activar las copias automáticas

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

![Petto confirma copias automáticas cada 24h, conservando las 7 últimas, y cuándo se hace la próxima](https://mintcdn.com/wikipetto/aURko5p8En80OELa/images/discord/guides/es/petto-vault-schedule.webp?fit=max\&auto=format\&n=aURko5p8En80OELa\&q=85\&s=99169cac3162b7b14faeab4e54c69aa6)

En Discord: !backup schedule 24 7: cada 24 horas, conservando 7.

`hours` va de 1 a 168 y `keep` de 1 a 30 (7 si no lo pones). Ejemplo: `!backup schedule 24 7` hace una copia cada 24 horas y conserva las últimas 7 automáticas. Para apagarlas:

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

![Petto confirma que las copias automáticas están apagadas](https://mintcdn.com/wikipetto/aURko5p8En80OELa/images/discord/guides/es/petto-vault-unschedule.webp?fit=max\&auto=format\&n=aURko5p8En80OELa\&q=85\&s=3864049b2429241102a93951fb5c6c6a)

En Discord: !backup unschedule.

### Borrar copias

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

Solo los **administradores** pueden borrar, y Petto te pide confirmar primero. Borrar todas las copias también apaga las automáticas. En el menú es **Borrar backups** (escribe un número, o `ALL`).

> [accordion] !backup delete \<id>
>
> ![liam usa !backup delete 5 y Petto pregunta en rojo si borra la copia 5, con Borrar y Cancelar](https://mintcdn.com/wikipetto/aURko5p8En80OELa/images/discord/guides/es/petto-vault-delete.webp?fit=max\&auto=format\&n=aURko5p8En80OELa\&q=85\&s=8f5f1184f23167e18f9a29338306ca45)
>
> En Discord: Petto pregunta antes de borrar una copia.
>
> ![La pregunta cambia a Copia 5 borrada](https://mintcdn.com/wikipetto/aURko5p8En80OELa/images/discord/guides/es/petto-vault-delete-done.webp?fit=max\&auto=format\&n=aURko5p8En80OELa\&q=85\&s=c630e569ecd1321fc311bc4b508fcc8b)
>
> En Discord: después de Borrar.

> [accordion] !backup delete --all true
>
> ![Petto pregunta en rojo si borra las 3 copias y apaga las automáticas](https://mintcdn.com/wikipetto/aURko5p8En80OELa/images/discord/guides/es/petto-vault-delete-all.webp?fit=max\&auto=format\&n=aURko5p8En80OELa\&q=85\&s=5803a97cfc33fffcb5d0a1d0e97c0e60)
>
> En Discord: borrar todas las copias también apaga las automáticas.

> [accordion] Borrar copias (menú)
>
> ![El cuadro Borrar copias con 5 escrito en el campo del número de copia o ALL](https://mintcdn.com/wikipetto/aURko5p8En80OELa/images/discord/guides/es/petto-vault-delete-modal.webp?fit=max\&auto=format\&n=aURko5p8En80OELa\&q=85\&s=ecaecf85f9db987ca28b061c9d1bf808)
>
> En Discord: en el menú, Borrar copias pide un número o ALL.

### Revisar la actividad

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

Muestra quién creó, exportó, restauró o borró copias y quién cambió la programación: las últimas 10 entradas, o hasta 20 con `limit`.

![Petto lista la actividad: una exportación de liam, una copia programada hecha por Petto, una copia de liam y un cambio de programación](https://mintcdn.com/wikipetto/aURko5p8En80OELa/images/discord/guides/es/petto-vault-audit.webp?fit=max\&auto=format\&n=aURko5p8En80OELa\&q=85\&s=50c80522829539ce0cab97b799b9ab5b)

En Discord: !backup audit: quién hizo qué y cuándo.

## Úsalo desde el dashboard

**Dashboard → Copias de seguridad** hace lo mismo: crear, exportar, programar, revisar la actividad y borrar. **Restaurar** abre una ventana con los mismos pasos (modo, qué recuperar, vista previa, verificación humana) y después muestra el progreso en vivo con un botón **Detener restauración**.

![La página de copias de seguridad con Crear una copia, Copias automáticas cada 24 horas conservando 7, tres copias guardadas, la tarjeta Tus datos y el historial de actividad](https://mintcdn.com/wikipetto/-zl3RNr1X6pRGWW3/images/dashboard/guides/es/petto-vault-dashboard.webp?fit=max\&auto=format\&n=-zl3RNr1X6pRGWW3\&q=85\&s=3dfa819ec0d841d98c2796d9ac89a66d)

Dashboard → Copias de seguridad: crear, programar, las copias guardadas con Exportar, Restaurar y borrar, Tus datos y la actividad.

> [accordion] Vista previa
>
> ![El diálogo de restauración con el contenido de la copia 6, los roles, canales y emojis para crear y actualizar, y en rojo los 2 canales y 1 rol que borraría](https://mintcdn.com/wikipetto/-zl3RNr1X6pRGWW3/images/dashboard/guides/es/petto-vault-dashboard-preview.webp?fit=max\&auto=format\&n=-zl3RNr1X6pRGWW3\&q=85\&s=772456e5785e817e57d12974efae066f)
>
> Dashboard → Copias de seguridad → Restaurar: lo que tiene la copia, lo que se crearía y actualizaría, y lo que replace borraría.

> [accordion] Comprobación humana
>
> ![El paso de comprobación con la imagen K7M2Q, la respuesta escrita y el botón Iniciar restauración](https://mintcdn.com/wikipetto/-zl3RNr1X6pRGWW3/images/dashboard/guides/es/petto-vault-dashboard-check.webp?fit=max\&auto=format\&n=-zl3RNr1X6pRGWW3\&q=85\&s=e8f10af59f8a2d275e30d4dec5679bda)
>
> Dashboard → Copias de seguridad → Restaurar: escribe las letras de la imagen y luego Iniciar restauración.

> [accordion] Progreso en vivo
>
> ![Restaurando la copia 6 al 45%, paso 19 de 42, restaurando canales, con el botón para detener](https://mintcdn.com/wikipetto/-zl3RNr1X6pRGWW3/images/dashboard/guides/es/petto-vault-dashboard-progress.webp?fit=max\&auto=format\&n=-zl3RNr1X6pRGWW3\&q=85\&s=67668283db8120a5fbe8cf0e73a534b2)
>
> Dashboard → Copias de seguridad → Restaurar: el progreso de la restauración, con Detener restauración.

> [accordion] El final
>
> ![Restauración terminada, con lo creado, actualizado y borrado y la nota de que la copia 8 tiene el servidor como estaba](https://mintcdn.com/wikipetto/-zl3RNr1X6pRGWW3/images/dashboard/guides/es/petto-vault-dashboard-end.webp?fit=max\&auto=format\&n=-zl3RNr1X6pRGWW3\&q=85\&s=ce2f111899c34d517b7a457d85c44ec3)
>
> Dashboard → Copias de seguridad → Restaurar: el final, con lo que cambió y la copia de seguridad previa.

> [accordion] Borrar un backup
>
> ![El diálogo Borrar un backup que pregunta si se borra la copia 5, con Cancelar y Borrar](https://mintcdn.com/wikipetto/-zl3RNr1X6pRGWW3/images/dashboard/guides/es/petto-vault-dashboard-delete.webp?fit=max\&auto=format\&n=-zl3RNr1X6pRGWW3\&q=85\&s=bec695d100bb139054fa7971ee14f854)
>
> Dashboard → Copias de seguridad: borrar una copia pregunta primero.

### Restaurar solo algunas partes

En el dashboard puedes elegir **qué recuperar**. Desmarca lo que debe quedarse como está ahora:

* **Roles**
* **Canales, categorías y permisos**
* **Ajustes del servidor**
* **Emojis**
* **Stickers**
* **Reglas de AutoMod**

![El primer paso del diálogo de restauración: Merge o Reemplazar, y las seis partes para recuperar, todas marcadas](https://mintcdn.com/wikipetto/-zl3RNr1X6pRGWW3/images/dashboard/guides/es/petto-vault-dashboard-mode.webp?fit=max\&auto=format\&n=-zl3RNr1X6pRGWW3\&q=85\&s=15194c95c4494dd46fab19358d22d547)

Dashboard → Copias de seguridad → Restaurar: el modo y Qué recuperar.

`replace` solo borra dentro de las partes que recuperas, así que restaurar solo los canales nunca borra un rol. La vista previa también dice qué contiene la copia: roles, categorías, canales, permisos de canal, emojis, stickers y reglas de AutoMod.

> [!TIP]
>
> Restaurar solo algunas partes es una opción del dashboard. `!backup restore` siempre recupera todas las partes.

La tarjeta **Tus datos** dice qué se guarda y te deja apagar las copias automáticas o borrarlo todo.

El dashboard nunca habla directamente con la base de datos. Las acciones pasan por el bot, que comprueba en Discord que tengas `Manage Server` o `Administrator` en ese servidor (restaurar y borrar necesitan `Administrator`).

## Base de datos dedicada

Vault usa su propia conexión de PostgreSQL a través de `PETTO_VAULT_DATABASE_URL`. Pon la contraseña como variable privada en el servidor donde corre y nunca la publiques en el repositorio. El bot y el dashboard comparten un secreto 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.