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

# Einrichtungsanleitung Discord-Bot-Hosting

> Registriere dich, löse eine Lizenz ein und bringe einen Node.js- oder Python-Discord-Bot auf EchoAuth Bothosting zum Laufen, inklusive Webhook-Empfang.

EchoAuth Bothosting betreibt deinen Discord-Bot in einem eigenen Container auf [bothosting-eu01.echoauth.dev](https://bothosting-eu01.echoauth.dev), mit einem Billing-Dashboard für dein Konto und deine Credits sowie einem auf [Pterodactyl](https://pterodactyl.io) basierenden Control Panel für den Server selbst (Konsole, Dateien und Startup-Einstellungen).

Diese Anleitung führt durch den kompletten Ablauf: Account erstellen, Lizenz einlösen, Server anlegen, Bot hochladen und Webhooks empfangen.

## Schnellstart

1. [Erstelle deinen Account](#create-your-account) unter [control-hosting.echoauth.dev/register](https://control-hosting.echoauth.dev/register)
2. [Löse deine Lizenz ein](#redeem-your-license) auf der Store-Seite, um Credits hinzuzufügen
3. [Lege einen Server an](#create-a-server): Runtime wählen, benennen, bestätigen
4. [Lade deine Bot-Dateien hoch](#upload-your-bot-files) und setze die Startup-Variablen
5. [Starte den Server und teste deinen Webhook](#start-the-server)

> [!NOTE]
>
> **Halte vor dem Start bereit:**
>
> * Einen Lizenzcode (aus der Checkout-E-Mail nach dem Kauf von Hosting-Zeit)
> * Den Code deines Bots: eine Node.js-`index.js` oder eine Python-`app.py`, plus eine Python-`requirements.txt`, falls du Abhängigkeiten hast

## Account erstellen

Gehe zu [control-hosting.echoauth.dev/register](https://control-hosting.echoauth.dev/register), erstelle einen Account und melde dich an. Du landest im Dashboard, das deine Serveranzahl und dein Credit-Guthaben zeigt.

![EchoAuth-Bothosting-Dashboard nach dem Login mit 0 Servern und 0.00 Credits](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/01-dashboard.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=44a55bf2156a5be753248292b30a0ffa)

Das Dashboard direkt nach dem Login: 0 Server, 0 Credits.

## Lizenz einlösen

Öffne **Store** in der Seitenleiste, klicke auf **Redeem code** und gib deinen Lizenzcode ein.

> [!TIP]
>
> 1 Credit = 1 Monat Laufzeit für einen Bot-Container. Es gibt keine Begrenzung, wie viele Container du betreiben kannst. Jeder braucht nur genug Credits, um seine monatlichen Kosten zu decken.

![Store-Seite mit Lizenzoptionen für 1, 6 und 12 Monate und einem Button Redeem code](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/02-store.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=d22be1809910deac312b6cc81cc0708f)

Die Store-Seite mit dem Button Redeem code und dem Preis 1 Credit = 1 Monat.

![Dialog Redeem voucher code mit eingegebenem Lizenzcode](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/03-redeem-filled.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=5e5333a498707f29e30f975978eef72b)

Ein eingegebener Lizenzcode im Dialog Redeem voucher code.

Nach dem Einlösen wird der Credit sofort deinem Guthaben gutgeschrieben und in den Activity Logs deines Dashboards protokolliert.

![Einlöse-Dialog mit Erfolgsmeldung, dass 1.00 Credit hinzugefügt wurde](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/04-redeem-success.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=a79d87f20c1c7ebed2268dbdcbecd925)

Eine erfolgreiche Einlösung schreibt den Credit sofort deinem Guthaben gut.

## Server anlegen

Gehe zu **Servers** und klicke auf **Create Server**. Gib einen Namen ein und wähle eine **Language**: **Node.js** oder **Python**. Standort und Ressourcenplan (das Produkt **Bot Container**: 0,3 vCPU, 256 MB RAM, 512 MB Speicher, 1 Backup, 1 Port, 1 Credit/Monat) werden automatisch eingetragen.

![Formular zum Anlegen eines Servers mit eingetragenem Namen, Node.js als Sprache und den Details des Bot-Container-Plans darunter](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/05-create-server.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=d2eca2740ee95cbaf0c73a1282542ab0)

Das Formular zum Anlegen eines Servers mit ausgewähltem Node.js, mit Ressourcenplan und Preis des Bot Containers.

Klicke auf **Create server**. Er wird sofort von deinem Credit-Guthaben abgebucht und erscheint auf der Servers-Seite als **Active**.

![Serverkarte mit Status Active, Spezifikation Node.js, Ressourcenplan Bot Container und einem Preis von 1.00 Credits pro Monat](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/06-server-active.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=8efdd67bc293af11210788908d4f7f12)

Der neue Server, aktiv und mit 1,00 Credit pro Monat berechnet.

## Rundgang durch das Control Panel

Klicke auf das Schraubenschlüssel-Symbol auf einer Serverkarte, um ihn im Control Panel unter [controlpanel.echoauth.dev](https://controlpanel.echoauth.dev) zu öffnen. Das Panel hat die Tabs **Console**, **Files**, **Databases**, **Schedules**, **Users**, **Backups**, **Network**, **Startup**, **Settings** und **Activity**.

![Pterodactyl-Panel-Dashboard mit dem neu angelegten Server](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/07-panel-dashboard.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=338631775f65f91731e5077d1d39bd43)

Die Serverliste des Control Panels, nachdem es aus dem Dashboard geöffnet wurde.

Ein frischer Server startet offline, mit leerem Dateimanager, und wartet auf deinen Code.

![Console-Tab mit Server als offline markiert, mit den Buttons Start, Restart und Stop](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/08-console-offline.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=065bea5d4fd06fd09ed92566554b0b8f)

Console-Tab auf einem Server, der noch nicht gestartet wurde.

![Leerer Dateimanager mit dem Verzeichnis /home/container ohne Dateien](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/09-files-empty.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=1bb3ee4e94d3e98217f508c56db8fa4d)

Der Dateimanager auf einem frisch angelegten Server.

## Bot-Dateien hochladen

Öffne zuerst den Tab **Startup**, um zu sehen, was deine Runtime erwartet.

> [tab] Node.js
>
> Der Startbefehl führt `${MAIN_FILE}` aus `/home/container` aus. Die Variable **Main File** hat den Standardwert **`index.js`**. Heißt deine Einstiegsdatei anders, passe die Variable entsprechend an (möglich sind `.js` oder `.ts`).
>
> ![Startup-Tab mit dem Node.js-Startbefehl und einem Docker-Image-Dropdown auf Nodejs 26](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/10-startup-command.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=44f941a8fa4f4797b6d95348d78b4af3)
>
> Node.js-Startbefehl und Docker-Image-Auswahl.
>
> ![Startup-Variable Main File mit dem Standardwert index.js](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/11-main-file.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=373d4355cf41af1cf989e5cc5e1f1d8b)
>
> Die Variable Main File mit dem Standardwert index.js.
>
> Bei der Node.js-Runtime gibt es keinen separaten HTTP/HTTPS-Schalter: Dein Code entscheidet, auf welchem Protokoll er lauscht.

> [tab] Python
>
> Der Startbefehl führt immer **`app.py`** aus `/home/container` aus. Benenne deine Einstiegsdatei genau so (die Variable "App Py File" ist nur beschreibend und wird nicht in den eigentlichen Befehl eingesetzt).
>
> ![Startup-Variable App Py File mit dem Standardwert app.py](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/19-python-main-file.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=0a2a66543153c5bf520179357ef7d1a5)
>
> Die Python-Variable App Py File, die app.py bleiben muss.
>
> Die Python-Runtime hat außerdem einen Schalter **Use HTTPS**: `0` = HTTP (Standard) und `1` = HTTPS. In diesem Fall sucht sie in deinem Serververzeichnis nach `cert.pem` und `key.pem` und greift auf ein selbstsigniertes Zertifikat zurück, falls sie fehlen.
>
> ![Startup-Variable Use HTTPS mit auf aus gestelltem Schalter, beschrieben als 0 = HTTP Standard, 1 = HTTPS](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/20-python-use-https.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=eb21f9df848c94c86d160a8158528de1)
>
> Die Variable Use HTTPS, nur in der Python-Runtime verfügbar.
>
> > [!WARNING]
> >
> > Der öffentliche HTTPS-Webhook-Proxy (unten) erwartet, dass dein Bot auf reinem HTTP lauscht. Lass **Use HTTPS** auf `0`, es sei denn, du terminierst TLS selbst und verbindest dich direkt mit deinem Port.
>
> Liste die Pakete, die dein Bot braucht, in **`requirements.txt`** auf. Sie werden beim Start automatisch installiert.

Öffne **Files**, klicke auf **New File** (oder **Upload**, um eine Datei von deinem Computer zu senden) und füge deinen Code hinzu.

![Editor für neue Dateien mit eingefügtem Beispielcode eines Webhook-Servers](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/12-new-file-editor.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=202c32cf6ecd7d4021aa46cd952ba328)

Bot-Code direkt im Dateieditor des Panels schreiben.

> [tab] Node.js
>
> ![Dateimanager mit index.js in /home/container](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/13-files-index-js.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=ed83b61d895d03949133422c43be0ce0)
>
> index.js hochgeladen und startbereit.

> [tab] Python
>
> ![Dateimanager mit app.py und requirements.txt in /home/container](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/21-python-files.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=8fb281d9be6156356abed7fcb9b1c0c6)
>
> app.py und requirements.txt hochgeladen und startbereit.

## Server starten

Gehe zu **Console** und klicke auf **Start**. Das Panel lädt das Docker-Image, führt deinen Startbefehl aus und streamt die Ausgabe live.

![Konsole mit dem laufenden Startskript und anschließend der Meldung Bot webhook server listening on port 25500](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/14-console-running.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=f118d50404f795183ec1dd8b0b1ef499)

Konsolenausgabe direkt nach dem Start eines Node.js-Servers, der Bot meldet, dass er lauscht.

## Adresse und Port deines Servers finden

Öffne den Tab **Network**. Die öffentliche Adresse deines Servers lautet `<hostname>:<port>`, zum Beispiel `bothosting-eu01.echoauth.dev:25500`. Erlaubte Ports liegen im Bereich `25500`–`25650`.

![Network-Tab mit Hostname bothosting-eu01.echoauth.dev und Port 25500](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/15-network-tab.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=72e0554fadab4528c1cbd9a90b694380)

Network-Tab mit Hostname und zugewiesenem Port des Servers.

## Webhooks empfangen

Es gibt zwei Wege, deinen Bot von außen zu erreichen:

| Format | URL | Hinweise |
| - | - | - |
| Direktes HTTP | `http://bothosting-eu01.echoauth.dev:<port>/<path>` | Trifft direkt den Port deines Containers. |
| HTTPS-Proxy | `https://bothosting-eu01.echoauth.dev/hook/<port>/<path>` | TLS wird für dich terminiert. Erfordert, dass dein Bot im HTTP-Modus läuft (`Use HTTPS = 0`). |

```bash Direct HTTP theme={null}
curl -X POST http://bothosting-eu01.echoauth.dev:25500/webhook \
  -H "Content-Type: application/json" \
  -d '{"event": "ping"}'
```

```bash HTTPS proxy theme={null}
curl -X POST https://bothosting-eu01.echoauth.dev/hook/25500/webhook \
  -H "Content-Type: application/json" \
  -d '{"event": "ping"}'
```

Beide liefern dieselbe Antwort des Beispiel-Bots von oben:

```json theme={null}
{"status": "ok", "received": true}
```

...und beide Aufrufe erscheinen live in der Konsole, zusammen mit CPU-, Speicher- und Uptime-Werten des Servers.

![Konsole mit zwei Zeilen Webhook received sowie den Kacheln Address, Uptime, CPU Load und Memory](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/16-webhook-logs.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=9da134cabf2ca3125e723ba7374ebc3b)

Zwei Webhook-Zustellungen, live in der Konsole protokolliert, mit Ressourcenstatistiken darunter.

Dasselbe funktioniert Ende-zu-Ende auch in der Python-Runtime:

![Python-Konsolenlog mit Serverstart und anschließend zwei Zeilen Webhook received von zwei verschiedenen Quell-IPs](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/22-python-webhook-logs.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=59e609ce210b24b4f1811e9e4300c632)

Ein Python-Bot protokolliert einen Webhook, der über den direkten Port und den HTTPS-Proxy empfangen wurde.

## Server verwalten

Nutze **Restart** und **Stop** im Console-Tab, um den laufenden Prozess zu steuern.

### Backups

Dein Bot-Container-Plan enthält 1 Backup-Slot. Öffne **Backups** und klicke auf **Create Backup**, um einen Snapshot deiner Dateien zu erstellen.

![Backups-Tab ohne gespeicherte Backups und mit einem Button Create Backup](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/17-backups-empty.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=9770bee3f420389ffac1676a6999477e)

Noch keine Backups: der Backups-Tab auf einem neuen Server.

![Backup-Liste mit einem vor wenigen Sekunden erstellten Backup, 1 von 1 Backups verwendet](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/18-backup-created.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=7ccf5835b8ca402d763fac7997c4ffbe)

Das erste Backup, erstellt und bereit.

### Lizenz verlängern

Kaufe oder löse einen weiteren Lizenzcode auf dieselbe Weise ein wie unter [Lizenz einlösen](#redeem-your-license). Die hinzugefügten Credits decken automatisch den nächsten monatlichen Abrechnungszeitraum deines Servers.

## Fehlerbehebung

> [accordion] Der Server startet nicht
>
> Prüfe den Tab **Startup**: Bei Node.js muss die Variable **Main File** genau zum Namen deiner hochgeladenen Datei passen. Bei Python muss deine Einstiegsdatei `app.py` heißen. Eine fehlende oder falsch benannte Datei ist die häufigste Ursache.

> [accordion] Port nicht erreichbar
>
> Nutze exakt den Hostnamen und den Port aus dem Tab **Network**, keinen selbst gewählten Port. Nur der zugewiesene Port (Bereich `25500`–`25650`) wird an deinen Container geroutet.

> [accordion] Webhook kommt nicht an
>
> Prüfe, ob du das richtige Format für den Modus deines Bots verwendest: Der HTTPS-Proxy (`/hook/<port>/<path>`) funktioniert nur, wenn dein Bot auf reinem HTTP lauscht (`Use HTTPS = 0` bei Python). Prüfe außerdem, ob der Pfad zu dem passt, was dein Code erwartet. Ein Tippfehler dort liefert ein 404 von deinem eigenen Server, nicht von EchoAuth.

> [accordion] Immer noch Probleme?
>
> Öffne **Support Ticket** in der Seitenleiste mit dem Namen deines Servers und dem, was du bereits versucht hast.

## FAQ

> [accordion] Wie viele Server kann ich betreiben?
>
> So viele, wie dein Credit-Guthaben erlaubt. Jeder Bot Container kostet 1 Credit (1 Monat) und wird monatlich von deinem Guthaben abgebucht.

> [accordion] Kann ich TypeScript in der Node.js-Runtime nutzen?
>
> Ja. Setze **Main File** auf eine `.ts`-Datei, dann läuft sie über `tsx` statt über `node`.

> [accordion] Brauche ich bei Python eine requirements.txt, wenn ich keine Abhängigkeiten habe?
>
> Nein, sie ist optional. Ist sie vorhanden, werden ihre Pakete bei jedem Start installiert. Nutzt dein Bot nur die Standardbibliothek, kannst du sie weglassen.

> [accordion] Was passiert, wenn meine Lizenz ausläuft?
>
> Löse einen neuen Lizenzcode auf der Store-Seite ein, bevor deine Credits auf null fallen. Die hinzugefügten Credits gelten automatisch für deinen nächsten Abrechnungszeitraum.


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