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.
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.
- VPS / Root-Server (Linux): volle Kontrolle, empfohlen für Bots mit Dashboard oder Datenbank. Ubuntu 22.04/24.04 oder Debian 12.
- Windows Server: funktioniert gut für Bots, für Websites aber unüblich. Du verbindest dich per Remotedesktop.
- 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.
Verbinde dich per SSH mit deinem Server. Unter Windows geht das direkt im Terminal (PowerShell):
ssh root@DEINE-SERVER-IPBring das System danach einmal auf den neuesten Stand:
sudo apt update && sudo apt upgrade -yDiscord-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.
- Öffne
discord.com/developers/applicationsund klick auf New Application. - Unter Bot klickst du auf Reset Token und kopierst den Token. Gib ihn niemals weiter.
- Ebenfalls unter Bot aktivierst du die Privileged Gateway Intents aus deiner README (meist Server Members und Message Content).
- Unter OAuth2 → URL Generator wählst du die Scopes
botundapplications.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.
Node.js installieren
Unsere Bots und Dashboards laufen mit Node.js. Wir empfehlen die aktuelle LTS-Version (22).
Installier Node.js 22 aus dem offiziellen NodeSource-Repository:
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejsPrüf, ob alles geklappt hat:
node -v
npm -vBot 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:
DISCORD_TOKEN=dein-bot-token
CLIENT_ID=deine-application-id
GUILD_ID=deine-server-idLeg einen Ordner an und lade die Dateien hoch, zum Beispiel mit WinSCP oder FileZilla (SFTP, gleicher Login wie SSH):
sudo mkdir -p /opt/bots/mein-bot
cd /opt/bots/mein-botPakete installieren, .env anlegen und den Bot bauen:
npm ci
cp .env.example .env
nano .env
npm run buildStarte ihn zum Testen einmal im Vordergrund. Ist der Bot in Discord online, beendest du ihn mit Strg + C:
npm startBot 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.
sudo npm install -g pm2
cd /opt/bots/mein-bot
pm2 start dist/index.js --name mein-bot
pm2 save
pm2 startuppm2 startup gibt einen weiteren Befehl aus. Kopier ihn und führ ihn aus, dann startet der Bot nach einem Neustart automatisch.
Nützliche Befehle:
pm2 logs mein-bot # Logs live ansehen
pm2 restart mein-bot # neu starten
pm2 status # alle ProzesseMySQL- / 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:
DATABASE_URL=mysql://novex:starkes-passwort@localhost:3306/novex_botsudo 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:
sudo mariadbCREATE 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.
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.
sudo apt install -y nginx
sudo nano /etc/nginx/sites-available/dashboardDashboard (eine Node.js-App, hier auf Port 3000) als Reverse Proxy:
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:
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:
sudo ln -s /etc/nginx/sites-available/dashboard /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginxHTTPS mit Let's Encrypt
Ein kostenloses SSL-Zertifikat, damit Dashboard und Website über https:// laden. Nginx muss schon eingerichtet sein.
sudo apt install -y certbot python3-certbot-nginx
sudo certbot --nginx -d dashboard.deine-domain.deCertbot passt deine Nginx-Konfiguration automatisch an und verlängert das Zertifikat selbst. Die Verlängerung kannst du testen:
sudo certbot renew --dry-runFirewall
Öffne nur, was du wirklich brauchst: SSH für dich und die Ports 80/443 für die Website. Bots brauchen keinen offenen Port.
sudo ufw allow OpenSSH
sudo ufw allow 'Nginx Full'
sudo ufw enable
sudo ufw statusErlaube OpenSSH immer vor ufw enable, sonst sperrst du dich selbst aus.
Updates & Fehlerhilfe
So spielst du eine neue Version von uns ein und das bedeuten die häufigsten Fehlermeldungen.
Used disallowed intents: aktivier die Intents aus deiner README im Developer Portal unter Bot.An invalid token was provided: Der Token in der.envist falsch oder wurde zurückgesetzt. Kopier einen neuen.Cannot find module: Es fehlen Pakete. Führnpm ciaus (Linux/Windows) oder starte den Server neu (Panel).ER_ACCESS_DENIED_ERROR: Benutzer oder Passwort inDATABASE_URLpassen nicht zur Datenbank.EADDRINUSE: Der Port ist schon belegt. ÄnderePORTin der.envoder beende das andere Programm.- Slash-Commands erscheinen nicht: Discord neu laden (
Strg + R). Globale Commands brauchen manchmal einen Moment.
Lade die neuen Dateien hoch (deine .env behältst du), dann:
cd /opt/bots/mein-bot
npm ci
npm run build
pm2 restart mein-bot