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

# Guía de configuración del alojamiento de bots de Discord

> Regístrate, canjea una licencia y pon en marcha un bot de Discord en Node.js o Python que reciba webhooks en EchoAuth Bothosting.

EchoAuth Bothosting ejecuta tu bot de Discord en su propio contenedor en [bothosting-eu01.echoauth.dev](https://bothosting-eu01.echoauth.dev), con un panel de facturación para tu cuenta y tus créditos, y un panel de control basado en [Pterodactyl](https://pterodactyl.io) para el propio servidor (consola, archivos y ajustes de inicio).

Esta guía recorre todo el proceso: crear una cuenta, canjear una licencia, crear un servidor, subir tu bot y recibir webhooks.

## Inicio rápido

1. [Crea tu cuenta](#create-your-account) en [control-hosting.echoauth.dev/register](https://control-hosting.echoauth.dev/register)
2. [Canjea tu licencia](#redeem-your-license) en la página Store para añadir créditos
3. [Crea un servidor](#create-a-server): elige un runtime, ponle nombre y confirma
4. [Sube los archivos de tu bot](#upload-your-bot-files) y define las variables de inicio
5. [Inicia el servidor y prueba tu webhook](#start-the-server)

> [!NOTE]
>
> **Ten preparado antes de empezar:**
>
> * Un código de licencia (del correo de compra tras adquirir tiempo de alojamiento)
> * El código de tu bot: un `index.js` de Node.js o un `app.py` de Python, más un `requirements.txt` de Python si tienes dependencias

## Crear tu cuenta

Ve a [control-hosting.echoauth.dev/register](https://control-hosting.echoauth.dev/register), crea una cuenta e inicia sesión. Llegas al panel, que muestra tu número de servidores y tu saldo de créditos.

![Panel de EchoAuth Bothosting tras iniciar sesión, con 0 servidores y 0.00 créditos](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)

El panel justo después de iniciar sesión: 0 servidores, 0 créditos.

## Canjear tu licencia

Abre **Store** en la barra lateral, haz clic en **Redeem code** e introduce tu código de licencia.

> [!TIP]
>
> 1 crédito = 1 mes de ejecución de un contenedor de bot, y no hay límite en cuántos contenedores puedes ejecutar: cada uno solo necesita créditos suficientes para cubrir su coste mensual.

![Página Store con las licencias de 1, 6 y 12 meses y un botón 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 página Store, con el botón Redeem code y el precio 1 crédito = 1 mes.

![Cuadro de diálogo Redeem voucher code con un código de licencia rellenado](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 código de licencia introducido en el cuadro de diálogo Redeem voucher code.

Una vez canjeado, el crédito se añade de inmediato a tu saldo y queda registrado en los Activity Logs de tu panel.

![Cuadro de diálogo Redeem con un mensaje de éxito que indica que se añadió 1.00 crédito](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)

Un canje correcto añade el crédito a tu saldo al instante.

## Crear un servidor

Ve a **Servers** y haz clic en **Create Server**. Ponle un nombre y elige un **Language**: **Node.js** o **Python**. La ubicación y el plan de recursos (el producto **Bot Container**: 0,3 vCPU, 256 MB de RAM, 512 MB de disco, 1 copia de seguridad, 1 puerto, 1 crédito/mes) se rellenan automáticamente.

![Formulario de creación de servidor con un nombre rellenado, Node.js como lenguaje y los detalles del plan Bot Container debajo](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)

El formulario de creación de servidor con Node.js seleccionado, mostrando el plan de recursos y el precio del Bot Container.

Haz clic en **Create server**. Se cobra de inmediato de tu saldo de créditos y aparece como **Active** en la página Servers.

![Tarjeta de servidor con estado Active, especificación Node.js, plan de recursos Bot Container y un precio de 1.00 créditos al mes](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)

El nuevo servidor, activo y facturado a 1,00 crédito al mes.

## Recorrido por el panel de control

Haz clic en el icono de la llave inglesa en la tarjeta de un servidor para abrirlo en el panel de control en [controlpanel.echoauth.dev](https://controlpanel.echoauth.dev). El panel tiene las pestañas **Console**, **Files**, **Databases**, **Schedules**, **Users**, **Backups**, **Network**, **Startup**, **Settings** y **Activity**.

![Panel de Pterodactyl con la lista del servidor recién creado](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 lista de servidores del panel de control tras abrirlo desde el panel.

Un servidor nuevo arranca sin conexión, con el gestor de archivos vacío, a la espera de tu código.

![Pestaña Console con el servidor marcado como offline y los botones Start, Restart y 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)

Pestaña Console en un servidor que aún no se ha iniciado.

![Gestor de archivos vacío con el directorio /home/container sin archivos](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)

El gestor de archivos en un servidor recién creado.

## Subir los archivos de tu bot

Abre primero la pestaña **Startup** para ver lo que espera tu runtime.

> [tab] Node.js
>
> El comando de inicio ejecuta `${MAIN_FILE}` desde `/home/container`. La variable **Main File** vale por defecto **`index.js`**. Si tu archivo de entrada tiene otro nombre, actualiza esta variable para que coincida (puede ser `.js` o `.ts`).
>
> ![Pestaña Startup con el comando de inicio de Node.js y un desplegable de imagen de Docker en 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)
>
> Comando de inicio de Node.js y selector de imagen de Docker.
>
> ![Variable de inicio Main File con el valor por defecto 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, con index.js por defecto.
>
> En el runtime de Node.js no hay un interruptor HTTP/HTTPS aparte: tu código decide en cuál escucha.

> [tab] Python
>
> El comando de inicio siempre ejecuta **`app.py`** desde `/home/container`. Pon a tu archivo de entrada exactamente ese nombre (la variable "App Py File" es solo descriptiva y no se sustituye en el comando real).
>
> ![Variable de inicio App Py File con el valor por defecto 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 App Py File de Python, que debe seguir siendo app.py.
>
> El runtime de Python también tiene un interruptor **Use HTTPS**: `0` = HTTP (por defecto) y `1` = HTTPS, en cuyo caso busca `cert.pem` y `key.pem` en el directorio de tu servidor y recurre a un certificado autofirmado si faltan.
>
> ![Variable de inicio Use HTTPS con un interruptor desactivado, descrita como 0 = HTTP por defecto, 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 solo en el runtime de Python.
>
> > [!WARNING]
> >
> > El proxy público de webhooks HTTPS (más abajo) espera que tu bot escuche en HTTP simple. Deja **Use HTTPS** en `0`, salvo que termines tú mismo el TLS y te conectes directamente a tu puerto.
>
> Enumera los paquetes que necesita tu bot en **`requirements.txt`**: se instala automáticamente al iniciar.

Abre **Files**, haz clic en **New File** (o en **Upload** para enviar un archivo desde tu ordenador) y añade tu código.

![Editor de archivo nuevo con código de ejemplo de un servidor de webhooks pegado](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)

Escribir el código del bot directamente en el editor de archivos del panel.

> [tab] Node.js
>
> ![Gestor de archivos con index.js en /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 subido y listo para ejecutarse.

> [tab] Python
>
> ![Gestor de archivos con app.py y requirements.txt en /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 y requirements.txt subidos y listos para ejecutarse.

## Iniciar el servidor

Ve a **Console** y haz clic en **Start**. El panel descarga la imagen de Docker, ejecuta tu comando de inicio y muestra la salida en directo.

![Consola con el script de inicio ejecutándose y después 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)

Salida de la consola justo después de iniciar un servidor de Node.js, con el bot indicando que está escuchando.

## Encontrar la dirección y el puerto de tu servidor

Abre la pestaña **Network**. La dirección pública de tu servidor es `<hostname>:<port>`, por ejemplo `bothosting-eu01.echoauth.dev:25500`. Los puertos permitidos están en el rango `25500`–`25650`.

![Pestaña Network con el nombre de host bothosting-eu01.echoauth.dev y el puerto 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)

Pestaña Network con el nombre de host y el puerto asignado del servidor.

## Recibir webhooks

Hay dos formas de llegar a tu bot desde fuera:

| Formato | URL | Notas |
| - | - | - |
| HTTP directo | `http://bothosting-eu01.echoauth.dev:<port>/<path>` | Llega directamente al puerto de tu contenedor. |
| Proxy HTTPS | `https://bothosting-eu01.echoauth.dev/hook/<port>/<path>` | El TLS se gestiona por ti. Requiere que tu bot esté en modo 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"}'
```

Ambos devuelven la misma respuesta del bot de ejemplo anterior:

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

...y ambas llamadas aparecen en directo en la consola, junto con las estadísticas de CPU, memoria y tiempo de actividad del servidor.

![Consola con dos líneas Webhook received, más los recuadros Address, Uptime, CPU Load y 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)

Dos entregas de webhook registradas en directo en la consola, con las estadísticas de recursos debajo.

Lo mismo funcionando de principio a fin en el runtime de Python:

![Registro de consola de Python con el arranque del servidor y después dos líneas Webhook received desde dos IP de origen distintas](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 de Python registrando un webhook recibido tanto por el puerto directo como por el proxy HTTPS.

## Gestionar tu servidor

Usa **Restart** y **Stop** en la pestaña Console para controlar el proceso en ejecución.

### Copias de seguridad

Tu plan Bot Container incluye 1 espacio de copia de seguridad. Abre **Backups** y haz clic en **Create Backup** para crear una instantánea de tus archivos.

![Pestaña Backups sin copias de seguridad almacenadas y con un botón 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)

Aún no hay copias de seguridad: la pestaña Backups en un servidor nuevo.

![Lista de copias de seguridad con una creada hace unos segundos, 1 de 1 copias usadas](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 primera copia de seguridad, creada y lista.

### Renovar tu licencia

Compra o canjea otro código de licencia del mismo modo que en [Canjear tu licencia](#redeem-your-license): los créditos añadidos cubren automáticamente el siguiente ciclo de facturación mensual de tu servidor.

## Solución de problemas

> [accordion] El servidor no arranca
>
> Revisa la pestaña **Startup**: en Node.js, la variable **Main File** debe coincidir exactamente con el nombre del archivo que subiste; en Python, tu archivo de entrada debe llamarse `app.py`. Un archivo que falta o que tiene mal el nombre es la causa más común.

> [accordion] Puerto inaccesible
>
> Usa exactamente el nombre de host y el puerto que aparecen en la pestaña **Network**, no un puerto elegido por ti: solo el puerto asignado (rango `25500`–`25650`) se enruta a tu contenedor.

> [accordion] El webhook no llega
>
> Confirma que usas el formato correcto para el modo de tu bot: el proxy HTTPS (`/hook/<port>/<path>`) solo funciona cuando tu bot escucha en HTTP simple (`Use HTTPS = 0` en Python). Comprueba también que la ruta coincide con la que espera tu código: un error tipográfico ahí devuelve un 404 de tu propio servidor, no de EchoAuth.

> [accordion] ¿Sigues atascado?
>
> Abre **Support Ticket** en la barra lateral indicando el nombre de tu servidor y lo que has probado.

## Preguntas frecuentes

> [accordion] ¿Cuántos servidores puedo ejecutar?
>
> Tantos como permita tu saldo de créditos: cada Bot Container cuesta 1 crédito (1 mes) y se factura mensualmente de tu saldo.

> [accordion] ¿Puedo usar TypeScript en el runtime de Node.js?
>
> Sí: define **Main File** como un archivo `.ts` y se ejecuta mediante `tsx` en lugar de `node`.

> [accordion] ¿Necesito un requirements.txt en Python si no tengo dependencias?
>
> No, es opcional. Si existe, sus paquetes se instalan en cada inicio; si tu bot solo usa la biblioteca estándar, puedes omitirlo.

> [accordion] ¿Qué pasa si mi licencia se agota?
>
> Canjea un nuevo código de licencia en la página Store antes de que tus créditos lleguen a cero: los créditos añadidos se aplican automáticamente a tu siguiente ciclo de facturación.


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