Stehst du vor der Herausforderung, deinen FiveM Server unter Linux Debian 12 neu aufzusetzen? Vielleicht läuft dein Server nicht mehr optimal, du hast Konfigurationsprobleme, die sich hartnäckig halten, oder du möchtest einfach nur mit einem sauberen System neu beginnen. Eine frische Installation kann Wunder wirken und die Performance sowie Stabilität deines Servers erheblich verbessern. Dieser umfassende Guide führt dich Schritt für Schritt durch den gesamten Prozess, von der Vorbereitung bis zum automatischen Start deines frisch installierten FiveM Servers.
Wir richten uns an jeden, der eine zuverlässige und detaillierte Anleitung sucht – egal ob du ein erfahrener Linux-Nutzer bist oder gerade erst deine ersten Schritte mit der Kommandozeile machst. Unser Ziel ist es, dir zu zeigen, wie du eine professionelle und wartungsfreundliche Serverumgebung schaffst.
Warum eine Neuinstallation? Die Vorteile auf einen Blick
Eine saubere Neuinstallation ist oft der beste Weg, um hartnäckige Probleme zu lösen oder die Leistung zu optimieren. Hier sind die Hauptgründe, die dafür sprechen:
- Performance-Steigerung: Ein frisches System ohne alte, ungenutzte Dateien oder fehlerhafte Konfigurationen kann die Serverleistung spürbar verbessern.
- Fehlerbehebung: Viele Bugs und Abstürze lassen sich auf Konflikte zwischen Ressourcen, veraltete Abhängigkeiten oder beschädigte Dateien zurückführen. Eine Neuinstallation eliminiert diese Fehlerquellen.
- Sicherheitsupdates: Mit einem aktuellen Debian 12 und den neuesten FiveM-Artefakten profitierst du von den neuesten Sicherheitsverbesserungen.
- Aufgeräumtes System: Eine Neuinstallation bietet die Möglichkeit, eine klare Ordnerstruktur und eine organisierte Konfiguration von Grund auf neu aufzubauen, was die zukünftige Wartung erleichtert.
- Neue Features: Du kannst die neuesten FiveM-Artefakte nutzen und sicherstellen, dass dein Server mit den aktuellen Standards kompatibel ist.
Vorbereitung ist alles: Was du vor dem Start wissen musst
Bevor wir loslegen, ist eine gründliche Vorbereitung entscheidend, um einen reibungslosen Ablauf zu gewährleisten und Datenverlust zu vermeiden:
- Backups erstellen: Dies ist der absolut wichtigste Schritt! Sichere alle wichtigen Daten deines bestehenden Servers. Dazu gehören:
- Deine
server.cfgDatei (speziell diesv_licenseKey!). - Alle deine FiveM Ressourcen (Skripte, Maps, Fahrzeuge etc.) im
resources-Ordner. - Deine Datenbank(en), falls du ESX, QBCore oder ähnliche Frameworks verwendest. Ein Dump deiner MariaDB/MySQL-Datenbank ist unerlässlich.
- Jegliche andere spezifische Konfigurationsdateien oder Custom-Dateien, die du über die Zeit hinzugefügt hast.
Verwende Befehle wie
cp -r /alter/pfad /neuer/pfad/backupfür Dateien und Ordner undmysqldump -u [user] -p [datenbankname] > backup.sqlfür Datenbanken. - Deine
- Debian 12 Installation: Dieser Guide geht davon aus, dass du bereits ein frisch installiertes Debian 12 System (ohne Desktop-Umgebung) hast und du über SSH darauf zugreifen kannst. Stelle sicher, dass du Root-Zugriff oder einen Benutzer mit
sudo-Rechten hast. - Grundlegende Linux-Kenntnisse: Ein grundlegendes Verständnis der Kommandozeile ist hilfreich, da alle Schritte über das Terminal ausgeführt werden.
- Systemressourcen: Stelle sicher, dass dein Server genügend RAM, CPU-Kerne und Speicherplatz für den geplanten Betrieb hat.
Nachdem du alle Vorbereitungen getroffen und deine Daten gesichert hast, können wir mit der Neuinstallation beginnen!
Schritt 1: System aktualisieren und grundlegende Pakete installieren
Zuerst aktualisieren wir das System und installieren einige nützliche Tools, die wir später benötigen.
sudo apt update && sudo apt upgrade -y
sudo apt install curl wget git unzip screen tar -y
apt update: Aktualisiert die Paketlisten.apt upgrade: Installiert die neuesten Versionen aller installierten Pakete.curl,wget: Zum Herunterladen von Dateien aus dem Internet.git: Zum Klonen von FiveM-Ressourcen von GitHub.unzip,tar: Zum Entpacken von Archiven.screen: Ein Terminal-Multiplexer, der es dir ermöglicht, Programme im Hintergrund laufen zu lassen, selbst wenn du deine SSH-Verbindung trennst. Alternativ kannst du auchtmuxverwenden.
Schritt 2: FiveM Server-Verzeichnis erstellen und Serverdateien herunterladen
Wir erstellen einen dedizierten Benutzer und ein Verzeichnis für unseren FiveM Server. Dies ist eine gute Sicherheitspraxis.
# Erstelle einen dedizierten Systembenutzer für den FiveM Server
sudo adduser --system --no-create-home --shell /usr/sbin/nologin fivem
# Erstelle das Hauptverzeichnis für den FiveM Server
sudo mkdir -p /opt/fivem
sudo chown fivem:fivem /opt/fivem
# Wechsle zum FiveM Benutzer und navigiere ins Verzeichnis
sudo -u fivem bash
cd /opt/fivem
Nun laden wir die neuesten FXServer-Artefakte herunter. Besuche die offizielle FiveM-Artefakte-Seite, um den Link zur neuesten empfohlenen Build (meistens die höchste „Recommended”-Version) zu finden. Ersetze [AKTUELLER_DOWNLOAD_LINK] mit dem tatsächlichen Link.
wget -N [AKTUELLER_DOWNLOAD_LINK] # Beispiel: wget -N https://artifacts.fivem.net/artif…
tar xf fx.tar.xz
# Benenne das extrahierte Verzeichnis um oder verschiebe es für eine saubere Struktur
mv fivem-server server # Oder den Namen, den das Archiv entpackt hat
Danach erstellen wir das server-data Verzeichnis, in dem sich die Konfigurationen und Ressourcen befinden:
mkdir server-data
Dein Verzeichnis /opt/fivem sollte nun etwa so aussehen:
/opt/fivem/
├── server/ # Enthält die ausführbaren FXServer-Dateien (run.sh, fxserver)
└── server-data/ # Enthält server.cfg, Ressourcen, Cache, Logs etc.
Du kannst die bash-Sitzung des FiveM-Benutzers jetzt mit exit verlassen.
Schritt 3: Datenbank-Server einrichten (Optional, aber empfohlen für ESX/QBCore)
Falls du Frameworks wie ESX oder QBCore verwenden möchtest, benötigst du einen Datenbank-Server. MariaDB ist eine beliebte und leistungsstarke Wahl.
sudo apt install mariadb-server -y
sudo mysql_secure_installation
Folge den Anweisungen von mysql_secure_installation. Es wird empfohlen, die Root-Anmeldung zu sperren, Passwörter zu setzen und Testdatenbanken zu entfernen.
Nun erstellen wir eine Datenbank und einen Benutzer für FiveM:
sudo mysql -u root -p
Gib dein MySQL-Root-Passwort ein und führe dann diese SQL-Befehle aus:
CREATE DATABASE fivem_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'fivemuser'@'localhost' IDENTIFIED BY 'DEIN_STARKES_PASSWORT';
GRANT ALL PRIVILEGES ON fivem_db.* TO 'fivemuser'@'localhost';
FLUSH PRIVILEGES;
EXIT;
Ersetze DEIN_STARKES_PASSWORT durch ein sicheres Passwort. Denke daran, dieses Passwort und den Datenbanknamen zu sichern, da du sie in deiner server.cfg und für Datenbankimporte benötigen wirst. Jetzt kannst du bei Bedarf deine alten Datenbank-Backups in diese neue Datenbank importieren.
Schritt 4: FiveM Server konfigurieren (server.cfg)
Die server.cfg ist das Herzstück deines FiveM Servers. Wir werden eine Beispielkonfiguration anpassen.
# Wechsle wieder zum fivem Benutzer, falls du es nicht schon bist
sudo -u fivem bash
cd /opt/fivem/server-data
# Kopiere die Beispiel-Konfiguration
cp ../server/resources/default/server.cfg server.cfg
Nun bearbeitest du die Datei server.cfg mit einem Texteditor wie nano:
nano server.cfg
Hier sind die wichtigsten Einstellungen, die du anpassen musst:
sv_licenseKey "deinLizenzschlüssel": Diesen Schlüssel erhältst du vom FiveM Keymaster. Ohne diesen Schlüssel startet dein Server nicht!endpoint_add_tcp "0.0.0.0:30120"undendpoint_add_udp "0.0.0.0:30120": Dies sind die Standardports. Ändere sie nur, wenn du einen bestimmten Grund dafür hast.sv_maxClients 32: Die maximale Anzahl der Spieler.rcon_password "deinRconPasswort": Setze ein sicheres Passwort für die RCON-Verbindung.sv_hostname "Dein Cooler FiveM Server": Der Name, der im Serverbrowser angezeigt wird.sets tags "friendly, roleplay, german": Tags, die deinen Server beschreiben.- Ressourcen starten: Füge
ensure [ressourcenname]für jede Ressource hinzu, die beim Serverstart geladen werden soll (z.B.ensure mapmanager,ensure chat,ensure spawnmanager,ensure qb-core). - ACLS konfigurieren: Für Admin-Rechte fügst du Zeilen wie diese hinzu (ersetze die Steam-ID):
add_ace group.admin command.quit allow add_ace group.admin command.toggleid allow # Füge hier deine Steam ID hinzu (convertiere sie von HEX zu DEZ wenn nötig) add_principal identifier.steam:110000100000000 group.admin
Speichere die Änderungen (STRG+X, Y, Enter bei nano).
Tipp: Für eine einfachere Verwaltung deiner FiveM Ressourcen und Konfigurationen empfiehlt sich die Installation von txAdmin. Du kannst es direkt als Ressource in deinem server.cfg starten (ensure txAdmin) und es bietet eine Web-Oberfläche für viele Server-Management-Aufgaben.
Schritt 5: FiveM Ressourcen hinzufügen (Optional)
Jetzt ist der Zeitpunkt, deine gesicherten Ressourcen in den neuen Server zu integrieren. Lade sie in das /opt/fivem/server-data/resources Verzeichnis hoch.
# Dies führt dich zum richtigen Ort
sudo -u fivem bash
cd /opt/fivem/server-data/resources
Hier kannst du nun deine gesicherten Ressourcen hochladen (z.B. per SFTP) oder von GitHub klonen:
git clone https://github.com/q …
Denke daran, jede neue Ressource in deiner server.cfg mit ensure [ressourcenname] zu aktivieren. Achte auf die korrekte Reihenfolge der Ressourcen, besonders bei Frameworks und deren Abhängigkeiten.
Verlasse die `bash`-Sitzung des FiveM-Benutzers mit `exit`.
Schritt 6: Firewall konfigurieren (UFW)
Eine Firewall ist unerlässlich für die Serversicherheit. Wir verwenden UFW (Uncomplicated Firewall).
sudo apt install ufw -y
# Erlaube SSH-Verbindungen
sudo ufw allow ssh
# Erlaube FiveM Standard-Ports (TCP und UDP)
sudo ufw allow 30120/tcp
sudo ufw allow 30120/udp
# Wenn du txAdmin verwendest, musst du dessen Standardport ebenfalls freigeben (meist 40120)
sudo ufw allow 40120/tcp
# Aktiviere die Firewall
sudo ufw enable
sudo ufw status
Bestätige mit ‘y’, wenn UFW fragt, ob es aktiviert werden soll. Überprüfe den Status, um sicherzustellen, dass die Regeln korrekt angewendet wurden.
Schritt 7: FiveM Server starten und Autostart einrichten
Bevor wir den Autostart konfigurieren, testen wir, ob der Server manuell startet.
sudo -u fivem bash # Wechsle zum fivem Benutzer
cd /opt/fivem/server-data
screen -S fivem-server # Starte eine screen-Sitzung
../server/run.sh +exec server.cfg
Überprüfe die Konsolenausgabe auf Fehler. Wenn alles korrekt startet, solltest du Meldungen wie „Got a connection!” oder „Hello world!” sehen. Du kannst die Screen-Sitzung mit STRG+A, D verlassen und der Server läuft im Hintergrund weiter. Mit screen -r fivem-server kehrst du zurück. Beende den Server in der Screen-Sitzung mit STRG+C und verlasse die `bash`-Sitzung des FiveM-Benutzers mit `exit`.
Autostart mit Systemd
Um sicherzustellen, dass dein FiveM Server nach einem Neustart des Systems automatisch startet, erstellen wir einen Systemd-Service.
sudo nano /etc/systemd/system/fivem.service
Füge den folgenden Inhalt in die Datei ein:
[Unit]
Description=FiveM Server
After=network.target
[Service]
Type=simple
User=fivem
Group=fivem
WorkingDirectory=/opt/fivem/server-data
ExecStart=/opt/fivem/server/run.sh +exec server.cfg
Restart=on-failure
RestartSec=5
[Install]
WantedBy=multi-user.target
Speichere die Datei (STRG+X, Y, Enter).
Aktualisiere Systemd, aktiviere den Service und starte ihn:
sudo systemctl daemon-reload
sudo systemctl enable fivem
sudo systemctl start fivem
Überprüfe den Status deines Servers:
sudo systemctl status fivem
Du solltest sehen, dass der Dienst aktiv ist (active (running)). Falls es Probleme gibt, kannst du die Logs mit journalctl -u fivem -f einsehen.
Fehlerbehebung und wichtige Hinweise
- Server startet nicht: Überprüfe die Logs (
journalctl -u fivem -f). Oft sind fehlendesv_licenseKey, falsche Pfade inserver.cfgoder fehlende Abhängigkeiten die Ursache. - Keine Verbindung zum Server: Stelle sicher, dass die Ports in deiner Firewall (UFW) korrekt geöffnet sind und dass dein Provider keine zusätzlichen Firewalls auf Serverseite betreibt.
- Ressourcenfehler: Achte auf Groß-/Kleinschreibung bei Ressourcennamen. Linux ist case-sensitive! Überprüfe die
server.cfgauf Tippfehler beiensure-Anweisungen. - Datenbankverbindung: Stelle sicher, dass Benutzername, Passwort und Datenbankname in den Konfigurationsdateien deiner Datenbank-Ressourcen korrekt sind und dass der MySQL-Server läuft.
- Systemressourcen: Wenn dein Server abstürzt oder sehr langsam ist, überprüfe die Auslastung von CPU und RAM mit Tools wie
htop. - FiveM Artefakte: Achte darauf, immer die neueste „Recommended” Build zu verwenden, um Kompatibilität und Performance zu gewährleisten.
Fazit
Herzlichen Glückwunsch! Du hast deinen FiveM Server unter Linux Debian 12 sauber neu installiert und für den automatischen Start konfiguriert. Du hast nun ein stabiles, performantes und wartungsfreundliches Fundament für deine FiveM-Community geschaffen. Mit diesem detaillierten Guide solltest du in der Lage sein, die Kontrolle über deinen Server vollständig zu übernehmen und ihn nach deinen Wünschen anzupassen.
Die Neuinstallation mag auf den ersten Blick entmutigend wirken, aber mit den richtigen Schritten und einer guten Vorbereitung ist es ein unkomplizierter Prozess, der sich langfristig auszahlt. Experimentiere mit neuen Ressourcen, optimiere deine Konfiguration und biete deinen Spielern das bestmögliche Erlebnis. Viel Spaß beim Aufbau deiner perfekten FiveM-Welt!