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

# Guide de configuration de l'hébergement de bots Discord

> Inscris-toi, utilise une licence et fais tourner un bot Discord Node.js ou Python qui reçoit des webhooks sur EchoAuth Bothosting.

EchoAuth Bothosting fait tourner ton bot Discord dans son propre conteneur sur [bothosting-eu01.echoauth.dev](https://bothosting-eu01.echoauth.dev), avec un tableau de bord de facturation pour ton compte et tes crédits, et un panel de contrôle basé sur [Pterodactyl](https://pterodactyl.io) pour le serveur lui-même (console, fichiers et paramètres de démarrage).

Ce guide couvre tout le parcours : créer un compte, utiliser une licence, créer un serveur, téléverser ton bot et recevoir des webhooks.

## Démarrage rapide

1. [Crée ton compte](#create-your-account) sur [control-hosting.echoauth.dev/register](https://control-hosting.echoauth.dev/register)
2. [Utilise ta licence](#redeem-your-license) sur la page Store pour ajouter des crédits
3. [Crée un serveur](#create-a-server) : choisis un runtime, nomme-le, confirme
4. [Téléverse les fichiers de ton bot](#upload-your-bot-files) et définis les variables de démarrage
5. [Démarre le serveur et teste ton webhook](#start-the-server)

> [!NOTE]
>
> **Prépare avant de commencer :**
>
> * Un code de licence (reçu dans l'e-mail de paiement après l'achat de temps d'hébergement)
> * Le code de ton bot : un `index.js` Node.js ou un `app.py` Python, plus un `requirements.txt` Python si tu as des dépendances

## Créer ton compte

Va sur [control-hosting.echoauth.dev/register](https://control-hosting.echoauth.dev/register), crée un compte et connecte-toi. Tu arrives sur le tableau de bord, qui affiche ton nombre de serveurs et ton solde de crédits.

![Tableau de bord EchoAuth Bothosting après connexion, affichant 0 serveur et 0.00 crédit](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)

Le tableau de bord juste après la connexion : 0 serveur, 0 crédit.

## Utiliser ta licence

Ouvre **Store** dans la barre latérale, puis clique sur **Redeem code** et saisis ton code de licence.

> [!TIP]
>
> 1 crédit = 1 mois de fonctionnement pour un conteneur de bot, et il n'y a aucune limite au nombre de conteneurs que tu peux faire tourner : chacun a simplement besoin d'assez de crédits pour couvrir son coût mensuel.

![Page Store listant les licences de 1, 6 et 12 mois et un bouton 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)

La page Store, avec le bouton Redeem code et le tarif 1 crédit = 1 mois.

![Boîte de dialogue Redeem voucher code avec un code de licence renseigné](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)

Un code de licence saisi dans la boîte de dialogue Redeem voucher code.

Une fois utilisé, le crédit est immédiatement ajouté à ton solde et consigné dans les Activity Logs de ton tableau de bord.

![Boîte de dialogue Redeem avec un message de succès indiquant que 1.00 crédit a été ajouté](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)

Une utilisation réussie ajoute immédiatement le crédit à ton solde.

## Créer un serveur

Va dans **Servers** et clique sur **Create Server**. Donne-lui un nom et choisis une **Language** : **Node.js** ou **Python**. L'emplacement et le plan de ressources (le produit **Bot Container** : 0,3 vCPU, 256 Mo de RAM, 512 Mo de disque, 1 sauvegarde, 1 port, 1 crédit/mois) se remplissent automatiquement.

![Formulaire de création de serveur avec un nom renseigné, Node.js comme langage et les détails du plan Bot Container en dessous](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)

Le formulaire de création de serveur avec Node.js sélectionné, affichant le plan de ressources et le prix du Bot Container.

Clique sur **Create server**. Il est facturé immédiatement sur ton solde de crédits et apparaît comme **Active** sur la page Servers.

![Carte de serveur affichant le statut Active, la spécification Node.js, le plan de ressources Bot Container et un prix de 1.00 crédit par mois](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)

Le nouveau serveur, actif et facturé 1,00 crédit par mois.

## Visite du panel de contrôle

Clique sur l'icône de clé à molette sur la carte d'un serveur pour l'ouvrir dans le panel de contrôle sur [controlpanel.echoauth.dev](https://controlpanel.echoauth.dev). Le panel comporte les onglets **Console**, **Files**, **Databases**, **Schedules**, **Users**, **Backups**, **Network**, **Startup**, **Settings** et **Activity**.

![Tableau de bord du panel Pterodactyl listant le serveur nouvellement créé](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)

La liste des serveurs du panel de contrôle après l'avoir ouvert depuis le tableau de bord.

Un serveur tout neuf démarre hors ligne, avec un gestionnaire de fichiers vide, en attendant ton code.

![Onglet Console affichant le serveur comme hors ligne, avec les boutons Start, Restart et 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)

Onglet Console sur un serveur qui n'a pas encore été démarré.

![Gestionnaire de fichiers vide affichant le répertoire /home/container sans fichiers](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)

Le gestionnaire de fichiers sur un serveur tout juste créé.

## Téléverser les fichiers de ton bot

Ouvre d'abord l'onglet **Startup** pour voir ce qu'attend ton runtime.

> [tab] Node.js
>
> La commande de démarrage exécute `${MAIN_FILE}` depuis `/home/container`. La variable **Main File** vaut **`index.js`** par défaut. Si ton fichier d'entrée porte un autre nom, mets à jour cette variable en conséquence (ce peut être `.js` ou `.ts`).
>
> ![Onglet Startup affichant la commande de démarrage Node.js et un menu d'image Docker réglé sur 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)
>
> Commande de démarrage Node.js et sélecteur d'image Docker.
>
> ![Variable de démarrage Main File avec la valeur par défaut 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)
>
> La variable Main File, à index.js par défaut.
>
> Il n'y a pas d'interrupteur HTTP/HTTPS séparé sur le runtime Node.js : c'est ton code qui décide sur lequel il écoute.

> [tab] Python
>
> La commande de démarrage exécute toujours **`app.py`** depuis `/home/container`. Nomme ton fichier d'entrée exactement ainsi (la variable "App Py File" est purement descriptive : elle n'est pas substituée dans la commande réelle).
>
> ![Variable de démarrage App Py File avec la valeur par défaut 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)
>
> La variable Python App Py File, qui doit rester app.py.
>
> Le runtime Python dispose aussi d'un interrupteur **Use HTTPS** : `0` = HTTP (par défaut) et `1` = HTTPS, auquel cas il cherche `cert.pem` et `key.pem` dans le répertoire de ton serveur et se rabat sur un certificat auto-signé s'ils sont absents.
>
> ![Variable de démarrage Use HTTPS avec un interrupteur désactivé, décrite comme 0 = HTTP par défaut, 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)
>
> La variable Use HTTPS, disponible uniquement sur le runtime Python.
>
> > [!WARNING]
> >
> > Le proxy webhook HTTPS public (ci-dessous) s'attend à ce que ton bot écoute en HTTP simple. Laisse **Use HTTPS** sur `0`, sauf si tu gères toi-même le TLS et te connectes directement à ton port.
>
> Indique les paquets dont ton bot a besoin dans **`requirements.txt`** : il est installé automatiquement au démarrage.

Ouvre **Files**, clique sur **New File** (ou **Upload** pour envoyer un fichier depuis ton ordinateur) et ajoute ton code.

![Éditeur de nouveau fichier avec un exemple de code de serveur webhook collé](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)

Écrire le code du bot directement dans l'éditeur de fichiers du panel.

> [tab] Node.js
>
> ![Gestionnaire de fichiers affichant index.js dans /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 téléversé et prêt à être exécuté.

> [tab] Python
>
> ![Gestionnaire de fichiers affichant app.py et requirements.txt dans /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 et requirements.txt téléversés et prêts à être exécutés.

## Démarrer le serveur

Va dans **Console** et clique sur **Start**. Le panel télécharge l'image Docker, exécute ta commande de démarrage et diffuse la sortie en direct.

![Console affichant le script de démarrage en cours d'exécution puis 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)

Sortie de la console juste après le démarrage d'un serveur Node.js, le bot indiquant qu'il écoute.

## Trouver l'adresse et le port de ton serveur

Ouvre l'onglet **Network**. L'adresse publique de ton serveur est `<hostname>:<port>`, par exemple `bothosting-eu01.echoauth.dev:25500`. Les ports autorisés se situent dans la plage `25500`–`25650`.

![Onglet Network avec le nom d'hôte bothosting-eu01.echoauth.dev et le 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)

Onglet Network affichant le nom d'hôte et le port attribué du serveur.

## Recevoir des webhooks

Il y a deux façons d'atteindre ton bot depuis l'extérieur :

| Format | URL | Remarques |
| - | - | - |
| HTTP direct | `http://bothosting-eu01.echoauth.dev:<port>/<path>` | Atteint directement le port de ton conteneur. |
| Proxy HTTPS | `https://bothosting-eu01.echoauth.dev/hook/<port>/<path>` | TLS géré pour toi. Nécessite que ton bot soit en mode HTTP (`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"}'
```

Les deux renvoient la même réponse du bot d'exemple ci-dessus :

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

...et les deux appels apparaissent en direct dans la console, avec les statistiques de CPU, de mémoire et de disponibilité du serveur.

![Console affichant deux lignes Webhook received, plus les tuiles Address, Uptime, CPU Load et 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)

Deux livraisons de webhook enregistrées en direct dans la console, avec les statistiques de ressources en dessous.

La même chose fonctionne de bout en bout sur le runtime Python :

![Journal de console Python affichant le démarrage du serveur puis deux lignes Webhook received provenant de deux IP sources différentes](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)

Un bot Python enregistrant un webhook reçu via le port direct et via le proxy HTTPS.

## Gérer ton serveur

Utilise **Restart** et **Stop** dans l'onglet Console pour contrôler le processus en cours.

### Sauvegardes

Ton plan Bot Container inclut 1 emplacement de sauvegarde. Ouvre **Backups** et clique sur **Create Backup** pour faire un instantané de tes fichiers.

![Onglet Backups n'affichant aucune sauvegarde stockée, avec un bouton 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)

Aucune sauvegarde pour l'instant : l'onglet Backups sur un nouveau serveur.

![Liste des sauvegardes affichant une sauvegarde créée il y a quelques secondes, 1 sauvegarde sur 1 utilisée](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)

La première sauvegarde, créée et prête.

### Renouveler ta licence

Achte ou utilise un autre code de licence de la même manière que dans [Utiliser ta licence](#redeem-your-license) : les crédits ajoutés couvrent automatiquement le prochain cycle de facturation mensuel de ton serveur.

## Dépannage

> [accordion] Le serveur ne démarre pas
>
> Vérifie l'onglet **Startup** : sur Node.js, la variable **Main File** doit correspondre exactement au nom du fichier téléversé ; sur Python, ton fichier d'entrée doit s'appeler `app.py`. Un fichier manquant ou mal nommé est la cause la plus fréquente.

> [accordion] Port inaccessible
>
> Utilise exactement le nom d'hôte et le port indiqués dans l'onglet **Network**, pas un port que tu as choisi toi-même : seul le port alloué (plage `25500`–`25650`) est routé vers ton conteneur.

> [accordion] Le webhook n'arrive pas
>
> Confirme que tu utilises le bon format pour le mode de ton bot : le proxy HTTPS (`/hook/<port>/<path>`) ne fonctionne que si ton bot écoute en HTTP simple (`Use HTTPS = 0` sur Python). Vérifie aussi que le chemin correspond à ce qu'attend ton code : une faute de frappe renvoie un 404 de ton propre serveur, pas d'EchoAuth.

> [accordion] Toujours bloqué ?
>
> Ouvre **Support Ticket** dans la barre latérale en indiquant le nom de ton serveur et ce que tu as déjà essayé.

## FAQ

> [accordion] Combien de serveurs puis-je faire tourner ?
>
> Autant que ton solde de crédits le permet : chaque Bot Container coûte 1 crédit (1 mois) et est facturé mensuellement sur ton solde.

> [accordion] Puis-je utiliser TypeScript sur le runtime Node.js ?
>
> Oui : définis **Main File** sur un fichier `.ts` et il s'exécute via `tsx` au lieu de `node`.

> [accordion] Ai-je besoin d'un requirements.txt sur Python si je n'ai aucune dépendance ?
>
> Non, il est facultatif. S'il est présent, ses paquets sont installés à chaque démarrage ; si ton bot n'utilise que la bibliothèque standard, tu peux l'omettre.

> [accordion] Que se passe-t-il si ma licence expire ?
>
> Utilise un nouveau code de licence sur la page Store avant que tes crédits n'atteignent zéro : les crédits ajoutés s'appliquent automatiquement à ton prochain cycle de facturation.


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