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

# Backup-Befehle

> Die Befehlsgruppe /backup — erstelle, liste auf, prüfe, stelle wieder her, plane, exportiere, importiere und lösche die Backups deines Servers direkt aus Discord.

`/backup` steuert [Server-Backup](/de/server-management/server-backup) direkt aus Discord heraus. Ein Befehl, **dreizehn Unterbefehle**.

| Voraussetzung     | Wert                                                                      |
| ----------------- | ------------------------------------------------------------------------- |
| **Du brauchst**   | Server verwalten                                                          |
| **Vetox braucht** | Kanal anzeigen, Nachrichtenverlauf lesen — plus mehr zum Wiederherstellen |
| **Abklingzeit**   | 5s                                                                        |
| **Wo**            | Nur auf Servern. Nicht in DMs verfügbar                                   |

<Warning>
  **Jede `/backup`-Antwort ist nur für dich sichtbar.** Eine Backup-ID ist ein Schlüssel zu den Inhalten deines Servers, deshalb postet Vetox nie eine dort, wo andere Mitglieder sie lesen können.
</Warning>

<Note>
  Jeder Unterbefehl lässt sich einzeln deaktivieren oder auf bestimmte Rollen und Kanäle beschränken — über die [Befehls-Verwaltung](/de/server-management/command-management). `/backup create` kann für deine Admins offen sein, während `/backup load` komplett aus ist.
</Note>

## Erstellen und prüfen

<AccordionGroup>
  <Accordion title="/backup create — ein Backup erstellen" icon="camera">
    | Option     | Erforderlich | Hinweise                                        |
    | ---------- | ------------ | ----------------------------------------------- |
    | `name`     | Nein         | Bis zu 64 Zeichen. Ein Name macht es auffindbar |
    | `messages` | Nein         | 0–250, gedeckelt auf das Maximum deiner Stufe   |

    Premium-Abschnitte werden automatisch bis zu dem einbezogen, was deine Stufe erlaubt. Die Antwort enthält die neue Backup-ID und wird dann laufend mit dem Fortschritt aktualisiert. Ist das Backup fertig, zeigt die Antwort die **ID**, die beiden Befehle, mit denen du es nutzt (`/backup info` und `/backup load`), und einen Link zum Backup im Dashboard — und bei Starter den Hinweis, dass Nachrichten, Mitgliederdaten, Banns und Anhänge nicht gesichert wurden.

    <Note>
      Ein manuelles Backup pro Server alle **10 Minuten**, und immer nur ein Backup- oder Wiederherstellungsauftrag gleichzeitig. Das Erstellen erfordert die Berechtigung Administrator — und unter der [Berechtigungsebene](/de/server-management/server-backup#berechtigungen) **Nur der Inhaber** allein den Inhaber.
    </Note>
  </Accordion>

  <Accordion title="/backup list — deine Backups ansehen" icon="list">
    | Option  | Erforderlich | Hinweise                                                                                               |
    | ------- | ------------ | ------------------------------------------------------------------------------------------------------ |
    | `page`  | Nein         | Ab 1. Zwanzig Zeilen pro Seite                                                                         |
    | `scope` | Nein         | **Dieser Server** (Standard), **Kanal-Backups dieses Servers** oder **Meine Backups auf jedem Server** |

    Das neueste zuerst. Automatische Backups und Sicherheitskopien sind markiert, damit du sie auf einen Blick auseinanderhalten kannst. `scope:mine` listet jedes Backup auf, das du erstellt hast, auf jedem Server, samt dem Server, aus dem es stammt — so findest du die ID eines anderswo erstellten Backups, bevor du es hier lädst.
  </Accordion>

  <Accordion title="/backup info — was ein Backup enthält" icon="circle-info">
    | Option      | Erforderlich | Hinweise                         |
    | ----------- | ------------ | -------------------------------- |
    | `backup_id` | **Ja**       | Wird beim Tippen vervollständigt |

    Anzahlen, die Optionen der Erfassung, die Größe, die aktivsten Kanäle, etwaige Warnungen, ob es durch deine Stufe gesperrt ist, und einen Link zum Backup im Snapshot-Viewer des Dashboards — dort kannst du jeden Kanal, jede Rolle, jede Einstellung, jeden Bann und jedes Mitglied darin nachlesen.
  </Accordion>
</AccordionGroup>

<Tip>
  `backup_id` wird bei jedem Unterbefehl, der eine ID nimmt, automatisch vervollständigt — du musst also nie eine ID von Hand kopieren. Angeboten werden nur Backups, die du verwenden darfst.
</Tip>

## Wiederherstellen

<AccordionGroup>
  <Accordion title="/backup load — ein Backup wiederherstellen" icon="rotate-left">
    | Option      | Erforderlich | Hinweise                                                                        |
    | ----------- | ------------ | ------------------------------------------------------------------------------- |
    | `backup_id` | **Ja**       | Wird vervollständigt, einschließlich deiner eigenen Backups aus anderen Servern |
    | `messages`  | Nein         | 0–250, gedeckelt auf das Maximum deiner Stufe                                   |
    | `options`   | Nein         | Bis zu 200 Zeichen. Siehe die Grammatik unten                                   |

    Beim ersten Drücken wird nichts wiederhergestellt. Vetox antwortet mit dem **Plan** — wie viele Kanäle und Rollen gelöscht und erstellt werden und ob Rollen über der eigenen Rolle von Vetox stehen und deshalb nicht angefasst werden können — hinter den Buttons **Bestätigen** und **Abbrechen**, die nach **60 Sekunden** ablaufen. Erst bei Bestätigen erstellt Vetox die Sicherheitskopie und startet die Wiederherstellung.

    <Warning>
      Ein Backup zu laden ersetzt die Kanäle und Rollen dieses Servers. Mitglieder werden nie gekickt, aber alles, was seit der Erstellung des Backups angelegt wurde, ist weg.
    </Warning>

    <Note>
      `/backup load` folgt der [Berechtigungsebene](/de/server-management/server-backup#berechtigungen) des Servers. Unter dem Standard **Admins dürfen keine zerstörerischen Aktionen ausführen** wird jede Person außer dem Inhaber abgewiesen, selbst mit Administrator.
    </Note>

    <Note>
      Wiederherstellungen und Rücknahmen sind täglich rationiert — **10 pro Server**, **20 pro Person**. `/backup load`, `/backup channel load` und das Zurücknehmen einer verfolgten Änderung zählen jeweils gegen beide Kontingente; das Fortsetzen einer fehlgeschlagenen Wiederherstellung nicht.
    </Note>
  </Accordion>

  <Accordion title="/backup cancel — den laufenden Auftrag stoppen" icon="ban">
    Keine Optionen. Bricht das aktive Backup oder die aktive Wiederherstellung dieses Servers ab. Der Prüfpunkt bleibt erhalten, eine abgebrochene Wiederherstellung lässt sich also weiterhin vom Dashboard aus fortsetzen.
  </Accordion>

  <Accordion title="/backup status — was läuft und welches Limit aktiv ist" icon="heart-pulse">
    Keine Optionen. Zeigt den Auftrag, der auf diesem Server läuft (Art, Phase, Fortschritt, Warnungen, Startzeit) — oder dass nichts läuft; wann das nächste manuelle Backup möglich ist, falls die 10-minütige Abklingzeit aktiv ist; wann **Discords Erstellungslimit** fällt, falls eine Wiederherstellung darauf gestoßen ist; und, wenn nichts läuft, warum der letzte Auftrag gestoppt hat und ob er sich vom Dashboard aus fortsetzen lässt.
  </Accordion>
</AccordionGroup>

### Die `options`-Grammatik

`options` ist eine durch Leerzeichen getrennte Liste von Tokens, angewendet **von links nach rechts**.

| Token                                                                                                      | Wirkung                      |
| ---------------------------------------------------------------------------------------------------------- | ---------------------------- |
| `settings` `roles` `delete-roles` `channels` `delete-channels` `members` `bans` `pins` `emojis` `stickers` | Schaltet diesen Teil **an**  |
| `!` vor einem davon — `!members`                                                                           | Schaltet diesen Teil **aus** |
| `*`                                                                                                        | Schaltet **alles** an        |
| `!*`                                                                                                       | Schaltet **alles** aus       |

Lässt du `options` ganz weg, verwendet Vetox den Standard: **`delete-channels channels delete-roles roles settings`** — ein vollständiges Ersetzen der Struktur, ohne Mitglieder, Banns, Pins, Emojis oder Sticker.

| Beispiel                                 | Ergebnis                                                                  |
| ---------------------------------------- | ------------------------------------------------------------------------- |
| `options:!* roles delete-roles`          | Nur Rollen — löscht die aktuellen Rollen und erstellt die des Backups neu |
| `options:!* channels roles settings`     | Struktur, zusätzlich zum Vorhandenen — es wird nichts gelöscht            |
| `options:* !members !bans`               | Alles außer Mitgliederdaten und Banns                                     |
| `options:!delete-channels !delete-roles` | Der Standard, additiv gemacht                                             |

<Warning>
  **Die Reihenfolge zählt.** `* !members` schaltet alles an und dann Mitglieder aus. `!members *` schaltet Mitglieder aus und dann alles wieder an, Mitglieder eingeschlossen. Lies deine Token-Liste von links nach rechts.
</Warning>

<Note>
  Tokens können nie erweitern, was deine Stufe erlaubt — das Stufenlimit wird zuletzt angewendet. Ein unbekanntes Token wird namentlich abgelehnt statt ignoriert, ein Tippfehler geht also nie stillschweigend verloren.
</Note>

## Planen

<AccordionGroup>
  <Accordion title="/backup interval — automatische Backups" icon="clock">
    | Option     | Erforderlich | Hinweise                                                              |
    | ---------- | ------------ | --------------------------------------------------------------------- |
    | `mode`     | **Ja**       | `on`, `off` oder `status`                                             |
    | `interval` | Nein         | 4 Stunden, 8 Stunden, 12 Stunden, 24 Stunden, 2 Tage, 3 Tage, 1 Woche |
    | `messages` | Nein         | 0–250, gedeckelt auf das Maximum deiner Stufe                         |

    `status` meldet den aktuellen Zeitplan, ohne ihn zu ändern: das Intervall, wie viele aufbewahrt werden, den letzten und den nächsten Lauf sowie die ID des neuesten automatischen Backups. Schaltest du den Zeitplan ein, erfährst du, wann das erste Backup läuft.

    <Note>
      Ein Intervall, das kürzer ist, als deine Stufe erlaubt, wird abgelehnt, und die Ablehnung nennt das Minimum deiner Stufe in Stunden. Automatische Backups rotieren: Die ältesten oberhalb der von deiner Stufe behaltenen Anzahl werden gelöscht, sobald neue hinzukommen.
    </Note>
  </Accordion>
</AccordionGroup>

## Kanal-Backups

<AccordionGroup>
  <Accordion title="/backup channel create — einen einzelnen Kanal sichern" icon="hashtag">
    | Option     | Erforderlich | Hinweise                                                       |
    | ---------- | ------------ | -------------------------------------------------------------- |
    | `channel`  | Nein         | Text, Ankündigung oder Thread. Standard ist der aktuelle Kanal |
    | `messages` | Nein         | 0–1000, gedeckelt auf das Maximum deiner Stufe                 |
    | `before`   | Nein         | Eine Nachrichten-ID. Speichert die Nachrichten **davor**       |

    <Tip>
      `before` ist der Weg, weiter zurückzugehen, als ein Durchlauf erlaubt: Erstelle ein Kanal-Backup und dann ein weiteres, bei dem `before` auf die älteste Nachrichten-ID gesetzt ist, die das erste erreicht hat.
    </Tip>
  </Accordion>

  <Accordion title="/backup channel load — sie in einen Kanal posten" icon="paste">
    | Option      | Erforderlich | Hinweise                                             |
    | ----------- | ------------ | ---------------------------------------------------- |
    | `backup_id` | **Ja**       | Vervollständigt ausschließlich Kanal-Backups         |
    | `channel`   | Nein         | Wohin gepostet wird. Standard ist der aktuelle Kanal |
    | `messages`  | Nein         | 0–1000, gedeckelt auf das Maximum deiner Stufe       |

    Die Nachrichten werden mit der ältesten zuerst gepostet, samt ihren Pins.

    <Note>
      **Es wird nichts gelöscht.** Die gespeicherten Nachrichten werden zu dem hinzugefügt, was bereits im Kanal steht. Ein großes Kanal-Backup braucht eine Weile — die Antwort meldet den Fortschritt unterwegs.
    </Note>
  </Accordion>
</AccordionGroup>

<Info>
  Kanal-Backups erfordern **Basic** oder höher.
</Info>

## Backups übertragen

<AccordionGroup>
  <Accordion title="/backup export — als JSON herunterladen" icon="file-export">
    | Option      | Erforderlich | Hinweise             |
    | ----------- | ------------ | -------------------- |
    | `backup_id` | **Ja**       | Wird vervollständigt |

    Sendet das Backup als `.json`-Datei im Discord-Format, angehängt an die nur für dich sichtbare Antwort. Über **8 MB** bekommst du stattdessen einen Dashboard-Link.

    <Note>
      Exporte enthalten den Server, Rollen, Kanäle, Emojis und Sticker. **Nachrichten, Mitglieder und Banns sind nicht enthalten** — stelle das Backup wieder her, um diese zu übertragen. Der Export funktioniert auf jeder Stufe.
    </Note>
  </Accordion>

  <Accordion title="/backup import — aus einer Datei ein Backup bauen" icon="file-import">
    | Option | Erforderlich | Hinweise                                           |
    | ------ | ------------ | -------------------------------------------------- |
    | `file` | **Ja**       | Eine Server-`.json` im Discord-Format, bis zu 5 MB |

    Vetox prüft die Datei, macht daraus ein Backup und antwortet mit dessen ID. Stelle es wieder her oder sieh es dir an wie jedes andere.

    <Warning>
      Eine Datei, die dem Server-Format von Discord nicht entspricht, wird rundweg abgelehnt, wobei das erste fehlgeschlagene Feld benannt wird. Vetox wendet nie eine halb an.
    </Warning>

    <Info>
      Der Import erfordert **Basic** oder höher.
    </Info>
  </Accordion>
</AccordionGroup>

## Löschen

<AccordionGroup>
  <Accordion title="/backup delete — ein einzelnes Backup löschen" icon="trash">
    | Option      | Erforderlich | Hinweise             |
    | ----------- | ------------ | -------------------- |
    | `backup_id` | **Ja**       | Wird vervollständigt |

    Fragt zuerst nach **Bestätigen**. Das Löschen entfernt den Snapshot und jede damit gespeicherte Datei, sofort und endgültig.
  </Accordion>

  <Accordion title="/backup purge — jedes Backup löschen" icon="dumpster-fire">
    Keine Optionen. Fragt nach **Bestätigen** und löscht dann **jedes** Backup dieses Servers samt den dazu gespeicherten Dateien.

    <Warning>
      Es gibt kein Rückgängig und keinen Papierkorb. Exportiere vorher alles, was du behalten möchtest.
    </Warning>
  </Accordion>
</AccordionGroup>

<Note>
  `/backup delete` und `/backup purge` sind zerstörerische Aktionen im Sinne der [Berechtigungsebene](/de/server-management/server-backup#berechtigungen) des Servers, unter der Standardebene sind sie also allein Sache des Inhabers.
</Note>

## Beispiele

```text theme={null}
/backup create name:before-rework
/backup list page:1
/backup list scope:mine
/backup info backup_id:GB7K2QX4M1ZP
/backup load backup_id:GB7K2QX4M1ZP options:!* channels roles
/backup status
/backup interval mode:on interval:12h
/backup channel create channel:#general messages:500
```

## Wenn ein Befehl abgelehnt wird

Vetox nennt immer den Grund. Die häufigsten:

| Die Antwort sagt                                                                  | Was zu tun ist                                                                                                                                            |
| --------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Hier wurde vor Kurzem ein Backup erstellt                                         | Warte die 10-minütige Erstellungs-Abklingzeit pro Server ab                                                                                               |
| Es läuft bereits ein anderer Backup-Auftrag                                       | Warte darauf oder nutze `/backup cancel`                                                                                                                  |
| Das heutige Limit für Wiederherstellungen und Rücknahmen ist erreicht             | Dieser Server oder dein Konto hat sein Tageskontingent von 10 pro Server / 20 pro Person aufgebraucht. Versuche es morgen erneut                          |
| Du hast das Backup-Limit deiner Stufe erreicht                                    | Lösche eins oder führe ein Upgrade durch                                                                                                                  |
| Dieses Backup liegt über dem Limit deiner Stufe                                   | Es ist durch ein Downgrade gesperrt. Lösche ein neueres Backup oder führe ein Upgrade durch                                                               |
| Das dürfen nur Personen, die die Backup-Berechtigungen des Servers zulassen       | Die Berechtigungsebene des Servers überlässt das dem Inhaber. Entweder handelt der Inhaber, oder er ändert die Ebene unter Einstellungen → Berechtigungen |
| Dieses Intervall ist kürzer, als deine Stufe erlaubt                              | Nutze das in der Meldung genannte Minimum oder führe ein Upgrade durch                                                                                    |
| Eine der gewählten Optionen ist ungültig                                          | Ein unbekanntes `options`-Token — prüfe es gegen die Grammatik oben                                                                                       |
| Vetox fehlen die benötigten Berechtigungen                                        | Gib Vetox Administrator und verschiebe seine Rolle über die Rollen, die wiederhergestellt werden                                                          |
| Discord erlaubt einem Bot nur 250 Rollen oder 500 Kanäle innerhalb von 48 Stunden | Discords eigenes Erstellungslimit. `/backup status` zeigt, wann es fällt; warte und setze fort, oder lade erneut mit `options:!delete-roles !roles`       |
| Diese Datei ist kein gültiger Discord-Server-Export                               | Die Importdatei entspricht nicht dem Format von Discord                                                                                                   |
| Server-Backup ist vorübergehend nicht verfügbar                                   | Für Wartungsarbeiten pausiert. Deine Backups sind unangetastet                                                                                            |

## Verwandt

<CardGroup cols={2}>
  <Card title="Server-Backup" icon="server" href="/de/server-management/server-backup">
    Die vollständige Funktion — Wiederherstellen, Zeitpläne, Änderungsverfolgung und Time Machine.
  </Card>

  <Card title="Meine Backups" icon="box-archive" href="/de/members/my-backups">
    Deine Backups über alle Server hinweg.
  </Card>

  <Card title="Befehls-Verwaltung" icon="sliders" href="/de/server-management/command-management">
    Deaktiviere oder beschränke jeden Unterbefehl einzeln.
  </Card>

  <Card title="Befehlsreferenz" icon="terminal" href="/de/commands/overview">
    Wie Berechtigungen und Abklingzeiten über alle Befehle hinweg funktionieren.
  </Card>
</CardGroup>