Setup Docs

Schritt für Schritt vom leeren Server zum laufenden Bot, Dashboard oder zur Website. Wähl dein Hosting und jeder Abschnitt zeigt dir die passenden Befehle.

Dein Hosting
Schritt 01

Bevor du startest

Diese Anleitung führt dich durch alles, was du brauchst, um einen Bot, ein Dashboard oder eine Website von uns auf deinem eigenen Server zu betreiben. Wähl oben deine Hosting-Art, dann zeigt dir jeder Abschnitt die passenden Schritte.

  1. VPS / Root-Server (Linux): volle Kontrolle, empfohlen für Bots mit Dashboard oder Datenbank. Ubuntu 22.04/24.04 oder Debian 12.
  2. Windows Server: funktioniert gut für Bots, für Websites aber unüblich. Du verbindest dich per Remotedesktop.
  3. Bot-Hosting mit Panel (Pterodactyl / Pelican): die einfachste Variante. Node.js und Neustarts übernimmt das Panel.

Alles, was speziell zu deinem Projekt gehört (Startdatei, Umgebungsvariablen, Ports), steht in der README.md, die du mit deinen Dateien von uns bekommst.

Linux-VPS

Verbinde dich per SSH mit deinem Server. Unter Windows geht das direkt im Terminal (PowerShell):

bash
ssh root@DEINE-SERVER-IP

Bring das System danach einmal auf den neuesten Stand:

bash
sudo apt update && sudo apt upgrade -y
Schritt 02

Discord-Anwendung anlegen

Falls wir den Bot-Account nicht für dich angelegt haben, erstellst du ihn selbst im Discord Developer Portal. Den Token brauchst du für die nächsten Schritte.

  1. Öffne discord.com/developers/applications und klick auf New Application.
  2. Unter Bot klickst du auf Reset Token und kopierst den Token. Gib ihn niemals weiter.
  3. Ebenfalls unter Bot aktivierst du die Privileged Gateway Intents aus deiner README (meist Server Members und Message Content).
  4. Unter OAuth2 → URL Generator wählst du die Scopes bot und applications.commands, setzt die Rechte und öffnest den erzeugten Link, um den Bot einzuladen.

Wer deinen Token hat, kontrolliert deinen Bot. Ist er einmal öffentlich geworden, klick sofort auf Reset Token und trag den neuen in deine .env ein.

Schritt 03

Node.js installieren

Unsere Bots und Dashboards laufen mit Node.js. Wir empfehlen die aktuelle LTS-Version (22).

Linux-VPS

Installier Node.js 22 aus dem offiziellen NodeSource-Repository:

bash
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

Prüf, ob alles geklappt hat:

bash
node -v
npm -v
Schritt 04

Bot einrichten und starten

Lade die Dateien hoch, die du von uns bekommen hast, installier die Pakete, trag deinen Token ein und starte den Bot.

Jedes Projekt hat eine .env.example. Kopier sie nach .env und füll die Werte aus. Mindestens:

.env
DISCORD_TOKEN=dein-bot-token
CLIENT_ID=deine-application-id
GUILD_ID=deine-server-id
Linux-VPS

Leg einen Ordner an und lade die Dateien hoch, zum Beispiel mit WinSCP oder FileZilla (SFTP, gleicher Login wie SSH):

bash
sudo mkdir -p /opt/bots/mein-bot
cd /opt/bots/mein-bot

Pakete installieren, .env anlegen und den Bot bauen:

bash
npm ci
cp .env.example .env
nano .env
npm run build

Starte ihn zum Testen einmal im Vordergrund. Ist der Bot in Discord online, beendest du ihn mit Strg + C:

bash
npm start
Schritt 05

Bot dauerhaft laufen lassen (PM2)

Damit der Bot weiterläuft, wenn du das Fenster schliesst, nach Abstürzen neu startet und nach einem Neustart des Servers wieder da ist.

Linux-VPS
bash
sudo npm install -g pm2
cd /opt/bots/mein-bot
pm2 start dist/index.js --name mein-bot
pm2 save
pm2 startup

pm2 startup gibt einen weiteren Befehl aus. Kopier ihn und führ ihn aus, dann startet der Bot nach einem Neustart automatisch.

Nützliche Befehle:

bash
pm2 logs mein-bot      # Logs live ansehen
pm2 restart mein-bot   # neu starten
pm2 status             # alle Prozesse
Schritt 06

MySQL- / MariaDB-Datenbank

Nur nötig, wenn deine README eine Datenbank erwähnt (z. B. für Level, Economy oder Tickets). MariaDB ist voll kompatibel mit MySQL.

Die Zugangsdaten trägst du danach in deine .env ein:

.env
DATABASE_URL=mysql://novex:starkes-passwort@localhost:3306/novex_bot
Linux-VPS
bash
sudo apt install -y mariadb-server
sudo mysql_secure_installation

Öffne die Datenbank-Konsole und leg eine Datenbank plus einen Benutzer für den Bot an:

bash
sudo mariadb
SQL
CREATE DATABASE novex_bot CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'novex'@'localhost' IDENTIFIED BY 'starkes-passwort';
GRANT ALL PRIVILEGES ON novex_bot.* TO 'novex'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Öffne Port 3306 nicht in der Firewall. Der Bot verbindet sich lokal, sonst braucht niemand Zugriff.

Schritt 07

Nginx für Dashboard & Website

Nginx macht dein Dashboard oder deine Website unter deiner eigenen Domain erreichbar. Richte vorher einen A-Eintrag deiner Domain auf die Server-IP.

Linux-VPS
bash
sudo apt install -y nginx
sudo nano /etc/nginx/sites-available/dashboard

Dashboard (eine Node.js-App, hier auf Port 3000) als Reverse Proxy:

/etc/nginx/sites-available/dashboard
server {
    listen 80;
    server_name dashboard.deine-domain.de;

    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

Website (statische Dateien, hochgeladen nach /var/www/website) stattdessen:

/etc/nginx/sites-available/website
server {
    listen 80;
    server_name deine-domain.de www.deine-domain.de;
    root /var/www/website;
    index index.html;

    location / {
        try_files $uri $uri/ /index.html;
    }
}

Konfiguration aktivieren, testen und Nginx neu laden:

bash
sudo ln -s /etc/nginx/sites-available/dashboard /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx
Schritt 08

HTTPS mit Let's Encrypt

Ein kostenloses SSL-Zertifikat, damit Dashboard und Website über https:// laden. Nginx muss schon eingerichtet sein.

Linux-VPS
bash
sudo apt install -y certbot python3-certbot-nginx
sudo certbot --nginx -d dashboard.deine-domain.de

Certbot passt deine Nginx-Konfiguration automatisch an und verlängert das Zertifikat selbst. Die Verlängerung kannst du testen:

bash
sudo certbot renew --dry-run
Schritt 09

Firewall

Öffne nur, was du wirklich brauchst: SSH für dich und die Ports 80/443 für die Website. Bots brauchen keinen offenen Port.

Linux-VPS
bash
sudo ufw allow OpenSSH
sudo ufw allow 'Nginx Full'
sudo ufw enable
sudo ufw status

Erlaube OpenSSH immer vor ufw enable, sonst sperrst du dich selbst aus.

Schritt 10

Updates & Fehlerhilfe

So spielst du eine neue Version von uns ein und das bedeuten die häufigsten Fehlermeldungen.

  1. Used disallowed intents: aktivier die Intents aus deiner README im Developer Portal unter Bot.
  2. An invalid token was provided: Der Token in der .env ist falsch oder wurde zurückgesetzt. Kopier einen neuen.
  3. Cannot find module: Es fehlen Pakete. Führ npm ci aus (Linux/Windows) oder starte den Server neu (Panel).
  4. ER_ACCESS_DENIED_ERROR: Benutzer oder Passwort in DATABASE_URL passen nicht zur Datenbank.
  5. EADDRINUSE: Der Port ist schon belegt. Ändere PORT in der .env oder beende das andere Programm.
  6. Slash-Commands erscheinen nicht: Discord neu laden (Strg + R). Globale Commands brauchen manchmal einen Moment.
Linux-VPS

Lade die neuen Dateien hoch (deine .env behältst du), dann:

bash
cd /opt/bots/mein-bot
npm ci
npm run build
pm2 restart mein-bot