Dokumentácia

Referenčný materiál, nie marketingový text

Inštalácia, konfigurácia, subsystémy a chyby, ktoré naozaj nastávajú. Každá referenčná stránka stojí sama o sebe a dá sa čítať bez zvyšku.

Yamiru · 2026-08-28

Dokumentácia Vorqul pokrýva požiadavky, inštaláciu a prvé nastavenie oboch produktov, na čo nadväzuje referenčná stránka ku každému subsystému: moderácia, automod a analytika pre VorqulBOT, a webhosting, DNS, mail, databázy, SFTP, firewall a monitoring pre VorqulPanel.

01 Požiadavky

VorqulPanel očakáva čistý server s Debian 12, Ubuntu 22.04+ alebo AlmaLinux 9, prístup pod rootom, aspoň 2 GB RAM a Java 17 alebo novšiu. VorqulBOT očakáva Node.js 18+ (22 LTS) a Discord aplikáciu so zapnutými intentmi message content a server members.

Linux server s prístupom pod rootom
Java 17+ pre panel
Node.js 18+ (22 LTS) pre bota
Kontajnerové prostredie je voliteľné, nie povinné

02 Inštalácia

Panel sa dodáva ako tenký JAR plus priečinok lib/ a pomocný skript, ktorý zaregistruje systemd unit, vytvorí servisného používateľa a otvorí port panelu. Bot sa dodáva ako repozitár, ktorý naklonujete, nastavíte cez .env a spustíte cez npm, Pterodactyl egg alebo priložený launcher.

Podrobné návody sú na /docs/install: VorqulBOT za asi desať minút, VorqulPanel za 15 až 30.

03 Prvé nastavenie

Pre panel: otvorte webové rozhranie na porte, ktorý vypíše inštalátor, vytvorte administrátorský účet, pridajte prvú doménu a spustite vstavaný test konfigurácie. Pre bota: pozvite ho s odporúčanou sadou oprávnení, zapnite moduly, ktoré potrebujete, a ešte pred čímkoľvek iným nastavte rolu pre tím a kanál na logy.

04 Riešenie problémov

Inštalácia balíkov zlyháva: takmer vždy je príčinou RestrictSUIDSGID=yes v systemd unite, ktoré rozbíja post-install skripty.
Panel nie je dostupný: firewall potrebuje výslovné pravidlo pre port panelu a pre SSH na vlastnom porte.
Certifikáty sú vydané, ale stránka stále beží na HTTP: prevzatý vhost potrebuje potvrdené prevzatie, kým ho panel prepíše.
Chýbajú slash príkazy: zopakujte krok deploy a overte, že v pozvánke bol scope applications.commands.

Inštalácia