# Draupnir bekommen

# Überblick: Draupnir-Instanz provisionieren

Um Draupnir nutzen zu können, benötigen Sie Ihre eigene Draupnir-Bot-Instanz.
Auf datenba.ch kann jeder Raum-Administrator eine solche Instanz selbstständig provisionieren.

Die Bereitstellung läuft folgendermaßen ab:

# Draupnir-Instanz anfordern

Laden Sie den Haupt-Draupnir-Servicebot (`<span class="editor-theme-code">@draupnir-main:datenba.ch</span>`)in einen Ihrer Räume ein, in dem Sie Administrator sind.

Dieser Servicebot fungiert als „Verteiler“ für neue Instanzen.

Sobald Sie ihn per Matrix-Invite in einen Raum einladen, erkennt der Service Ihre Anforderung.

**Automatische Bereitstellung:**  
Wenn Sie berechtigt sind (i.d.R. alle lokalen Admin-Nutzer, sofern vom Serverbetreiber freigegeben), wird Ihre Anfrage automatisch verarbeitet.

Der Service lehnt die Einladung zum ursprünglichen Raum ab, erstellt im Hintergrund eine neue Draupnir-Bot-Instanz für Sie und bereitet einen Verwaltungsraum vor.

# Einladung in den Verwaltungsraum (Kontrollraum)

Kurz darauf erhalten Sie vom Draupnir-Service eine Einladung in einen neuen Raum, der Ihre persönliche Draupnir-Instanz repräsentiert.

Nehmen Sie diese Einladung unbedingt an.

Dieser spezielle Raum dient zugleich als Steuerungsraum und als Policy-Listen-Raum für Ihren Bot.

Sie können sich das als Ihr „Kontrollzentrum“ vorstellen, in dem Sie Befehle an Draupnir senden und wo Draupnir Informationen für Sie bereitstellt.

# Voraussetzungen

Stellen Sie sicher, dass Ihr Konto die nötigen Rechte hat.

Sie sollten mindestens in einem Raum Admin sein, um dort den Servicebot einzuladen.

Zudem müssen Räume, die Sie schützen wollen, auf dem Homeserver datenba.ch liegen bzw. von einem lokalen Admin (Ihnen) verwaltet werden.

Externe Nutzer können in der Regel keine Instanz auf einem fremden Homeserver provisionieren, außer der Serverbetreiber erlaubt dies ausdrücklich.

# Räume schützen: Draupnir in Räume bringen

**Bot in Räume einladen:**  
Laden Sie Ihren persönlichen Draupnir-Bot (`<span class="editor-theme-code">@draupnir_IhrBot:datenba.ch</span>`) in jeden Raum ein, den er moderieren soll.

Sobald Sie den Bot eingeladen haben, reagiert Draupnir im Kontrollraum mit einer Rückfrage, ob dieser Raum geschützt werden soll.

Sie können dann z.B. per Klick auf einen vorgeschlagenen Button oder Reaktion („OK“) bestätigen.

Bei Bestätigung fügt Draupnir den Raum zu seiner Schutzliste hinzu und markiert dies in der Regel mit einem grünen Häkchen im Kontrollraum.

**(Hinweis: Funktioniert die automatische Abfrage nicht, prüfen Sie, ob der Bot ausreichend Berechtigungen hat und ob der Raum eventuell verschlüsselt ist.)**

**Manueller Befehl:**  
Alternativ können Sie im Kontrollraum den Befehl  
`<span class="editor-theme-code">!draupnir rooms add <Raum></span>`  
nutzen.

Dabei können Sie entweder die Raum-ID oder eine Raum-Alias-URL angeben.

Beispiel:  
`<span class="editor-theme-code">!draupnir rooms add https://matrix.to/#/#meinraum:datenba.ch</span>`

Der Bot versucht dann, dem genannten Raum beizutreten und ihn unter Schutz zu stellen.

Beachten Sie: Bei privaten Räumen müssen Sie den Bot-Benutzer zuerst manuell einladen, bevor der Befehl funktioniert, da sonst der Beitritt verweigert wird.

# Kontrolle & Empfehlung zur Nutzung

<span style="white-space: pre-wrap;">Nachdem Sie alle gewünschten Räume hinzugefügt haben, können Sie mit </span>`<span class="editor-theme-code">!draupnir rooms list</span>`<span style="white-space: pre-wrap;"> im Kontrollraum überprüfen, welche Räume aktuell geschützt sind.</span>

**Tipp:**  
Sie können eine Draupnir-Instanz für beliebig viele Ihrer Räume nutzen.

Es ist nicht nötig (und oft unübersichtlich), für jeden Raum eine eigene Instanz zu betreiben.

Fügen Sie lieber einen Bot mehreren Räumen hinzu, um zentrale Listen und Einstellungen zu teilen.