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

# Installatiehandleiding Discord-bothosting

> Registreer, wissel een licentie in en krijg een Node.js- of Python-Discord-bot draaiend en webhooks ontvangend op EchoAuth Bothosting.

EchoAuth Bothosting draait je Discord-bot in een eigen container op [bothosting-eu01.echoauth.dev](https://bothosting-eu01.echoauth.dev), met een factureringsdashboard voor je account en tegoed en een op [Pterodactyl](https://pterodactyl.io) gebaseerd controlepaneel voor de server zelf (console, bestanden en opstartinstellingen).

Deze handleiding doorloopt het hele proces: een account aanmaken, een licentie inwisselen, een server aanmaken, je bot uploaden en webhooks ontvangen.

## Snelstart

1. [Maak je account aan](#maak-je-account-aan) op [control-hosting.echoauth.dev/register](https://control-hosting.echoauth.dev/register)
2. [Wissel je licentie in](#wissel-je-licentie-in) op de Store-pagina om tegoed toe te voegen
3. [Maak een server aan](#maak-een-server-aan) — kies een runtime, geef hem een naam en bevestig
4. [Upload je botbestanden](#upload-je-botbestanden) en stel de opstartvariabelen in
5. [Start de server en test je webhook](#start-de-server)

> [!NOTE]
>
> **Zorg dat je dit klaar hebt voordat je begint:**
>
> * Een licentiecode (uit een checkoutmail nadat je hostingtijd hebt gekocht)
> * De code van je bot — een Node.js-`index.js` of een Python-`app.py`, plus een Python-`requirements.txt` als je afhankelijkheden hebt

## Maak je account aan

Ga naar [control-hosting.echoauth.dev/register](https://control-hosting.echoauth.dev/register), maak een account aan en log in. Je komt op het Dashboard, dat je aantal servers en je tegoedsaldo toont.

![EchoAuth Bothosting-dashboard na het inloggen, met 0 servers en 0,00 tegoed](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)

Het dashboard direct na het inloggen: 0 servers, 0 tegoed.

## Wissel je licentie in

Open **Store** in de zijbalk, klik op **Redeem code** en voer je licentiecode in.

> [!TIP]
>
> 1 tegoed = 1 maand runtime voor één botcontainer, en er is geen limiet aan het aantal containers dat je kunt draaien — elke container heeft alleen genoeg tegoed nodig om zijn maandelijkse kosten te dekken.

![Store-pagina met licentieopties voor 1, 6 en 12 maanden en een knop 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)

De Store-pagina, met de knop Redeem code en de prijs 1 tegoed = 1 maand.

![Dialoogvenster Redeem voucher code met een ingevulde licentiecode](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)

Een licentiecode ingevoerd in het dialoogvenster Redeem voucher code.

Na het inwisselen wordt het tegoed direct aan je saldo toegevoegd en vastgelegd in de Activity Logs van je dashboard.

![Inwisseldialoog met een succesmelding dat 1,00 tegoed is toegevoegd](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)

Een geslaagde inwisseling voegt het tegoed direct aan je saldo toe.

## Maak een server aan

Ga naar **Servers** en klik op **Create Server**. Geef hem een naam en kies een **Language**: **Node.js** of **Python**. De locatie en het resourceplan (het product **Bot Container**: 0,3 vCPU, 256 MB RAM, 512 MB schijfruimte, 1 back-up, 1 poort, 1 tegoed per maand) worden automatisch ingevuld.

![Formulier voor het aanmaken van een server met een ingevulde naam, Node.js als taal en de details van het plan Bot Container eronder](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)

Het formulier voor het aanmaken van een server met Node.js geselecteerd, met het resourceplan Bot Container en de prijs.

Klik op **Create server**. Het bedrag wordt direct van je tegoedsaldo afgeschreven en de server verschijnt als **Active** op de Servers-pagina.

![Serverkaart met status Active, specificatie Node.js, resourceplan Bot Container en een prijs van 1,00 tegoed per maand](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)

De nieuwe server, actief en gefactureerd tegen 1,00 tegoed per maand.

## Rondleiding door het controlepaneel

Klik op het moersleutelicoon op een serverkaart om hem te openen in het controlepaneel op [controlpanel.echoauth.dev](https://controlpanel.echoauth.dev). Het paneel heeft de tabbladen **Console**, **Files**, **Databases**, **Schedules**, **Users**, **Backups**, **Network**, **Startup**, **Settings** en **Activity**.

![Dashboard van het Pterodactyl-paneel met de zojuist aangemaakte 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)

De serverlijst van het controlepaneel nadat je het vanuit het dashboard hebt geopend.

Een nieuwe server staat eerst offline, met een lege bestandsbeheerder, en wacht op je code.

![Tabblad Console met de server als offline gemarkeerd en de knoppen Start, Restart en 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)

Tabblad Console op een server die nog niet is gestart.

![Lege bestandsbeheerder met de map /home/container zonder bestanden](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)

De bestandsbeheerder op een nieuw aangemaakte server.

## Upload je botbestanden

Open eerst het tabblad **Startup** om te zien wat je runtime verwacht.

> [tab] Node.js
>
> Het opstartcommando voert `${MAIN_FILE}` uit vanuit `/home/container`. De variabele **Main File** staat standaard op **`index.js`** — heeft je hoofdbestand een andere naam, pas dan deze variabele aan (het kan `.js` of `.ts` zijn).
>
> ![Tabblad Startup met het Node.js-opstartcommando en een Docker-imagedropdown ingesteld op 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)
>
> Opstartcommando voor Node.js en de selectie van het Docker-image.
>
> ![Opstartvariabele Main File met standaardwaarde 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)
>
> De variabele Main File, standaard index.js.
>
> Er is geen aparte HTTP/HTTPS-schakelaar in de Node.js-runtime — je code bepaalt waarop hij luistert.

> [tab] Python
>
> Het opstartcommando voert altijd **`app.py`** uit vanuit `/home/container` — noem je hoofdbestand precies zo (de variabele "App Py File" is alleen beschrijvend; hij wordt niet in het eigenlijke commando ingevuld).
>
> ![Opstartvariabele App Py File met standaardwaarde 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)
>
> De Python-variabele App Py File, die app.py moet blijven.
>
> De Python-runtime heeft ook een schakelaar **Use HTTPS**: `0` = HTTP (standaard) en `1` = HTTPS. In dat geval zoekt hij naar `cert.pem` en `key.pem` in je servermap en valt hij terug op een zelfondertekend certificaat als die ontbreken.
>
> ![Opstartvariabele Use HTTPS met een schakelaar op uit, beschreven als 0 = HTTP standaard, 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)
>
> De variabele Use HTTPS, alleen beschikbaar in de Python-runtime.
>
> > [!WARNING]
> >
> > De openbare HTTPS-webhookproxy (hieronder) verwacht dat je bot op gewoon HTTP luistert. Laat **Use HTTPS** op `0` staan, tenzij je zelf TLS afhandelt en rechtstreeks verbinding maakt met je poort.
>
> Zet de pakketten die je bot nodig heeft in **`requirements.txt`** — die worden bij het opstarten automatisch geïnstalleerd.

Open **Files**, klik op **New File** (of op **Upload** om een bestand van je computer te sturen) en voeg je code toe.

![Editor voor een nieuw bestand met voorbeeldcode van een webhookserver erin geplakt](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)

Botcode rechtstreeks schrijven in de bestandseditor van het paneel.

> [tab] Node.js
>
> ![Bestandsbeheerder met 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 geüpload en klaar om te draaien.

> [tab] Python
>
> ![Bestandsbeheerder met app.py en 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 en requirements.txt geüpload en klaar om te draaien.

## Start de server

Ga naar **Console** en klik op **Start**. Het paneel haalt het Docker-image op, voert je opstartcommando uit en toont de uitvoer live.

![Console waarin het opstartscript draait en daarna 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)

Consoleuitvoer direct nadat een Node.js-server is gestart, waarin de bot meldt dat hij luistert.

## Vind het adres en de poort van je server

Open het tabblad **Network**. Het openbare adres van je server is `<hostname>:<port>` — bijvoorbeeld `bothosting-eu01.echoauth.dev:25500`. Toegestane poorten liggen in het bereik `25500`–`25650`.

![Tabblad Network met hostnaam bothosting-eu01.echoauth.dev en poort 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)

Tabblad Network met de hostnaam en toegewezen poort van de server.

## Webhooks ontvangen

Er zijn twee manieren om je bot van buitenaf te bereiken:

| Formaat | URL | Opmerkingen |
| - | - | - |
| Directe HTTP | `http://bothosting-eu01.echoauth.dev:<port>/<path>` | Raakt rechtstreeks de poort van je container. |
| HTTPS-proxy | `https://bothosting-eu01.echoauth.dev/hook/<port>/<path>` | TLS wordt voor je afgehandeld — vereist dat je bot in HTTP-modus staat (`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 geven hetzelfde antwoord van de voorbeeldbot hierboven:

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

...en beide aanroepen verschijnen live in de console, samen met de CPU-, geheugen- en uptimestatistieken van de server.

![Console met twee logregels Webhook received, plus de statistiektegels Address, Uptime, CPU Load en 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)

Twee webhookleveringen live gelogd in de console, met resourcestatistieken eronder.

Hetzelfde werkt end-to-end op de Python-runtime:

![Python-consolelog met het starten van de server en daarna twee regels Webhook received van twee verschillende bron-IP's](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)

Een Python-bot die een ontvangen webhook logt, zowel via de directe poort als via de HTTPS-proxy.

## Beheer je server

Gebruik **Restart** en **Stop** op het tabblad Console om het draaiende proces te besturen.

### Back-ups

Je plan Bot Container bevat 1 back-upslot. Open **Backups** en klik op **Create Backup** om een momentopname van je bestanden te maken.

![Tabblad Backups zonder opgeslagen back-ups en een knop 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)

Nog geen back-ups — het tabblad Backups op een nieuwe server.

![Back-uplijst met één back-up van enkele seconden geleden, 1 van 1 back-ups gebruikt](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)

De eerste back-up, aangemaakt en klaar.

### Verleng je licentie

Koop of wissel een extra licentiecode op dezelfde manier in als bij [Wissel je licentie in](#wissel-je-licentie-in) — het toegevoegde tegoed dekt automatisch de volgende maandelijkse factureringscyclus van je server.

## Probleemoplossing

> [accordion] Server start niet
>
> Controleer het tabblad **Startup**: bij Node.js moet de variabele **Main File** precies overeenkomen met de naam van je geüploade bestand; bij Python moet je hoofdbestand `app.py` heten. Een ontbrekend of verkeerd benoemd bestand is de meest voorkomende oorzaak.

> [accordion] Poort niet bereikbaar
>
> Gebruik de exacte hostnaam en poort van het tabblad **Network**, niet een poort die je zelf hebt gekozen — alleen de toegewezen poort (bereik `25500`–`25650`) wordt naar je container gerouteerd.

> [accordion] Webhook komt niet aan
>
> Controleer of je het juiste formaat gebruikt voor de modus van je bot: de HTTPS-proxy (`/hook/<port>/<path>`) werkt alleen als je bot op gewoon HTTP luistert (`Use HTTPS = 0` bij Python). Controleer ook of het pad overeenkomt met wat je code verwacht — een typfout daar levert een 404 op van je eigen server, niet van EchoAuth.

> [accordion] Nog steeds vast?
>
> Open **Support Ticket** in de zijbalk met je servernaam en wat je hebt geprobeerd.

## Veelgestelde vragen

> [accordion] Hoeveel servers kan ik draaien?
>
> Zoveel als je tegoedsaldo toelaat — elke Bot Container kost 1 tegoed (1 maand) en wordt maandelijks van je saldo afgeschreven.

> [accordion] Kan ik TypeScript gebruiken in de Node.js-runtime?
>
> Ja — stel **Main File** in op een `.ts`-bestand en het wordt uitgevoerd via `tsx` in plaats van `node`.

> [accordion] Heb ik bij Python een requirements.txt nodig als ik geen afhankelijkheden heb?
>
> Nee — het is optioneel. Als het bestand er is, worden de pakketten bij elke start geïnstalleerd; gebruikt je bot alleen de standaardbibliotheek, dan kun je het weglaten.

> [accordion] Wat gebeurt er als mijn licentie opraakt?
>
> Wissel een nieuwe licentiecode in op de Store-pagina voordat je tegoed op nul staat — het toegevoegde tegoed wordt automatisch toegepast op je volgende factureringscyclus.


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