Material de referencia, no texto de marketing

01 Requisitos

VorqulPanel espera un servidor limpio con Debian 12, Ubuntu 22.04+ o AlmaLinux 9, acceso root, al menos 2 GB de RAM y Java 17 o superior. VorqulBOT espera Node.js 18+ (22 LTS) y una aplicación de Discord con los intents message content y server members activados.

• Servidor Linux con acceso root
• Java 17+ para el panel
• Node.js 18+ (22 LTS) para el bot
• Un entorno de contenedores es opcional, no obligatorio

02 Instalación

El panel se distribuye como un JAR ligero más un directorio lib/ y un script auxiliar que registra la unidad systemd, crea el usuario de servicio y abre el puerto del panel. El bot se distribuye como un repositorio que clonas, configuras mediante .env y ejecutas con npm, un egg de Pterodactyl o el lanzador incluido.

Las guías paso a paso están en /docs/install: VorqulBOT en unos diez minutos, VorqulPanel en 15 a 30.

03 Primera configuración

Para el panel: abre la interfaz web en el puerto que imprime el instalador, crea la cuenta de administrador, añade tu primer dominio y ejecuta la prueba de configuración integrada. Para el bot: invítalo con el conjunto de permisos recomendado, activa los módulos que necesites y, antes que nada, define un rol de equipo y un canal de registro.

04 Resolución de problemas

• Fallan las instalaciones de paquetes: casi siempre es RestrictSUIDSGID=yes en la unidad systemd rompiendo los scripts post-install.
• El panel no responde: el cortafuegos necesita una regla explícita para el puerto del panel y para SSH en un puerto personalizado.
• Certificados emitidos pero el sitio sigue sirviendo HTTP: un vhost adoptado necesita una toma de control confirmada antes de que el panel lo reescriba.
• Faltan los comandos slash: repite el paso de despliegue y confirma que el scope applications.commands estaba en la invitación.