Wie man die server.cfg auf seinem FiveM-Server konfiguriert
Einführung
Die Datei server.cfg ist die zentrale Konfigurationsdatei eines FiveM-Servers. Diese Anleitung zeigt, wie Sie die server.cfg Ihres FiveM-Servers in OuiPanel konfigurieren, dem Spielpanel von OuiHeberg. Sie geht jede gängige Einstellung mit ihrer Zeile durch und endet mit einem vollständigen Beispiel.
| Bereich | Beispiele |
|---|---|
| Identität | Servername, Beschreibung, Tags |
| Lizenz | Cfx.re-Lizenzschlüssel, Pflicht |
| Spieler | Anzahl der Slots, OneSync |
| Ressourcen | Skripte, Maps, Fahrzeuge |
| Berechtigungen | ACE und ACL, Admins, Gruppen |
| Netzwerk | Ports, RCON |
Einen Lizenzschlüssel erhalten
Ohne Lizenzschlüssel startet ein FiveM-Server nicht. Der Schlüssel ist kostenlos und wird im Cfx.re-Portal erstellt, dem Nachfolger von Keymaster.
Melden Sie sich auf portal.cfx.re mit Ihrem Cfx.re-Konto an. Die alte Adresse
keymaster.fivem.netleitet ebenfalls dorthin. Ohne Konto klicken Sie auf Sign Up.Öffnen Sie die Seite Server Registration Keys und klicken Sie auf Generate Key.
Geben Sie unter Display Name einen Namen für den Schlüssel ein und klicken Sie auf Generate.
Kopieren Sie den neuen Schlüssel. Er beginnt mit
cfxk_.
Die Anleitung Keymaster FiveM erklärt das Portal, die Verwaltung der Schlüssel und die Lizenzfehler im Detail.

Ein Schlüssel gilt immer nur für einen Server. Halten Sie ihn geheim und erstellen Sie für jeden weiteren Server einen eigenen.
Die Datei server.cfg öffnen
Melden Sie sich bei OuiPanel unter dash.ouipanel.com an und öffnen Sie Ihren FiveM-Server.
Stoppen Sie den Server in der Konsole mit der Schaltfläche Stoppen.
Klicken Sie im Seitenmenü auf Dateimanager.
Klicken Sie im Hauptverzeichnis auf
server.cfg. Das Fenster „Bearbeite server.cfg“ öffnet sich.Bearbeiten Sie die Datei und klicken Sie auf Speichern.
Starten Sie den Server über die Konsole neu.
Die Zeilen unter ### AUTOMATICALLY SET BY PTERODACTYL ### am Anfang der Datei schreibt das Panel. Lassen Sie sie unverändert.

Stoppen Sie den Server, bevor Sie diese Datei bearbeiten. Der Server liest die server.cfg erst beim nächsten Start neu ein.
Die Edition Legacy oder Enhanced wählen
OuiPanel bietet FiveM in zwei Editionen an, Legacy und Enhanced. Das Panel nennt sie Kanäle. Sie wählen die Edition unter FiveM-Konfiguration in der Karte FiveM-Kanal. Das Abzeichen Aktuell markiert die Edition des Servers.
Zwischen den Editionen wechseln
Klicken Sie im Seitenmenü auf FiveM-Konfiguration.
Klicken Sie in der Karte FiveM-Kanal auf Legacy oder Enhanced.
Das Fenster „Vor der Installation sichern“ öffnet sich. Klicken Sie auf Speichern und fortfahren oder auf Ohne Backup fortfahren.
Das Panel installiert den Server in der gewählten Edition neu. Laut der Karte behält der Wechsel Ihre Konfiguration.

Tragen Sie vor dem Wechsel zu Enhanced Ihren eigenen Schlüssel in die Variable fivem license ein. Ohne ihn beendet sich der Server beim Start.
Was sich im Panel ändert
| Einstellung | Legacy | Enhanced |
|---|---|---|
| txAdmin | Verfügbar, mit den Variablen txAdmin Port und Activer txadmin | Nicht verfügbar, die Seite zeigt dazu den Hinweis „txAdmin auf Enhanced nicht verfügbar“ |
| Artefakt-Version | Auswahl aus einer Liste über Eine Version auswählen | Schaltfläche ausgegraut, die Auswahl aus der Liste ist Legacy vorbehalten |
| Installierte Version | Build-Nummer, zum Beispiel 38220 | Kurze Kennung, zum Beispiel 019ffb4d |
| Versionsvariable | fivem version | fivem version (Enhanced / UUID) |
Die Anleitung Die Artifact-Version des FiveM-Servers ändern erklärt die Wahl eines Builds auf Legacy. Wie Sie txAdmin öffnen, steht in FiveM-Whitelist mit Discord und txAdmin einrichten.

Grundkonfiguration
Lizenzschlüssel (Pflicht)
sv_licenseKey "ihr_lizenzschluessel_hier"
Ersetzen Sie den Wert durch den Schlüssel aus dem Cfx.re-Portal. Ohne gültigen Schlüssel startet der Server nicht.
In OuiPanel tragen Sie den Schlüssel außerdem unter Konfiguration › Servereinstellungen ein, im Block Umgebungsvariablen, Feld fivem license. Fügen Sie den Schlüssel ein und klicken Sie auf das Häkchen rechts neben dem Feld, um ihn zu speichern. Enthält Ihre server.cfg eine Zeile sv_licenseKey, tragen Sie dort denselben Schlüssel ein.
In der Edition Enhanced ist ein eigener Schlüssel Pflicht. Der voreingestellte Schlüssel der Variable wird dort von Cfx.re abgelehnt, und der Server beendet sich sofort beim Start.
Im selben Block finden Sie Nom du serveur (Servername), Joueurs maximum (maximale Spielerzahl) und Clé API Web Steam (obsolète) (Steam-Web-API-Schlüssel, veraltet). Halten Sie die Werte in den Variablen und in der Datei gleich. Auf Legacy enthält er außerdem txAdmin Port und den Schalter Activer txadmin (txAdmin aktivieren).

Servername
sv_hostname "Mein FiveM-Server | Roleplay DE"
Das ist der Name in der FiveM-Serverliste. Ein paar Tipps für die Wahl.
Kurz und leicht zu merken.
Mit der Art des Servers (RP, Freeroam, Drift…).
Mit der Sprache (DE, EN…).
Emojis nur sparsam.
Einige Beispiele.
sv_hostname "[DE] Revolution RP | Seriöses Roleplay"
sv_hostname "Los Santos Life | RP auf Deutsch"
sv_hostname "Drift Paradise | Rennen & Tuning"
Serverbeschreibung
sets sv_projectDesc "Deutscher Roleplay-Server mit realistischer Wirtschaft, vielen Berufen und aktiver Community."
Die Beschreibung erscheint in den Serverdetails. Bleiben Sie unter 200 Zeichen.
Projektname
sets sv_projectName "Revolution RP"
Das ist der kurze Projektname, der in einigen Menüs erscheint.
Die Dokumentation von Cfx.re führt
sv_projectName,sv_projectDescundload_server_iconals veraltet. Name, Beschreibung und Symbol lassen sich auch im Cfx.re-Portal festlegen.
Server-Tags
sets tags "roleplay, deutsch, serious, economy, jobs"
Tags helfen, den Server in der Liste zu finden. Trennen Sie sie mit Kommas. Die gängigsten sind diese.
roleplay,rp,serious,semi-seriousdeutsch,german,deeconomy,jobs,police,emscustom-cars,drift,racingesx,qbcore,vrp
Serversymbol
load_server_icon server_icon.png
Diese Zeile zeigt ein Symbol in der Serverliste. Das Bild muss ein PNG mit 96 × 96 Pixeln sein, server_icon.png heißen und im Hauptverzeichnis des Servers liegen. Zum Hochladen ziehen Sie es im Dateimanager auf das Hauptverzeichnis.
Spielerkonfiguration
Anzahl der Slots
sv_maxclients 32
Über 32 Slots muss OneSync aktiviert sein. Über 64 muss es auf on stehen. Die Obergrenze hängt auch von Ihrem Cfx.re-Konto ab.
| Slots | Voraussetzung |
|---|---|
32 | Kleiner Server oder Testserver |
48 | Obergrenze ohne Cfx.re-Abo, mit OneSync |
64 bis 128 | Abo Element Club Argentum oder Aurum |
Bis 2048 | Abo Element Club Platinum, OneSync auf on |
Die Variable Joueurs maximum in den Servereinstellungen legt dieselbe Zahl fest. Mehr Spieler brauchen auch mehr Arbeitsspeicher und Prozessorleistung.
OneSync aktivieren
Mit OneSync sind mehr als 32 Spieler möglich, und die Synchronisierung wird besser.
set onesync on
| Modus | Wirkung |
|---|---|
off | Deaktiviert, höchstens 32 Spieler |
on | Aktiviert, der empfohlene Modus |
legacy | Kompatibilitätsmodus, von Cfx.re nicht empfohlen |
Für eine feinere OneSync-Konfiguration ergänzen Sie diese Zeilen.
set onesync on
set onesync_population true
# Nimmt entfernte Entitäten außerhalb des Sichtfelds aus der Synchronisierung
set onesync_distanceCulling true
set onesync_distanceCullVehicles false
Spawnpunkt
Der Spawnpunkt wird nicht in der server.cfg festgelegt. Er steht in einer Map-Ressource, mit X-, Y- und Z-Koordinaten. Die meisten Frameworks (ESX, QBCore) regeln das Spawnen selbst.
spawnpoint 'a_m_y_hipster_01' { x = -269.4, y = -955.3, z = 31.2 }
Ressourcenkonfiguration
Eine Ressource starten
ensure name_der_ressource
Der Befehl start funktioniert ebenfalls.
start name_der_ressource
Verwenden Sie lieber
ensure. Der Befehl startet die Ressource oder startet sie neu, wenn sie schon läuft.
Ladereihenfolge
Die Reihenfolge der ensure-Zeilen ist wichtig, weil manche Ressourcen von anderen abhängen. Eine empfohlene Reihenfolge.
# 1. FiveM-Grundressourcen
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure hardcap
ensure rconlog
# 2. Datenbank
ensure oxmysql
# 3. Framework (ESX oder QBCore)
ensure es_extended
# 4. Gemeinsame Abhängigkeiten
ensure esx_menu_default
ensure esx_menu_dialog
ensure esx_menu_list
# 5. Wichtige Skripte
ensure esx_identity
ensure esx_society
ensure esx_billing
ensure esx_banking
# 6. Jobs / Berufe
ensure esx_policejob
ensure esx_ambulancejob
ensure esx_mechanicjob
# 7. Weitere Skripte
ensure esx_vehicleshop
ensure esx_property
ensure esx_skin
# 8. Eigene Skripte
ensure mein_eigenes_skript
Eine Ressource deaktivieren
Um eine Ressource zu deaktivieren, kommentieren Sie ihre Zeile mit # aus.
# ensure deaktivierte_ressource
Nützliche Konsolenbefehle
Diese Befehle geben Sie in der Konsole von OuiPanel ein, ohne Schrägstrich davor.
| Befehl | Wirkung |
|---|---|
restart [ressource] | Startet eine Ressource neu |
stop [ressource] | Stoppt eine Ressource |
start [ressource] | Startet eine Ressource |
refresh | Aktualisiert die Ressourcenliste |
status | Zeigt die verbundenen Spieler |
quit | Stoppt den Server |
Datenbankkonfiguration
MySQL-Verbindung
set mysql_connection_string "mysql://user:password@host:3306/database?charset=utf8mb4"
Ersetzen Sie jeden Teil durch die Daten Ihrer Datenbank.
userist der MySQL-Benutzername.passwordist sein Passwort.hostist die Adresse des MySQL-Servers.3306ist der MySQL-Port.databaseist der Name der Datenbank.
Diese Daten finden Sie unter Datenbanken, Schaltfläche Informationen. Die Anleitung Eine MySQL-Datenbank in OuiPanel erstellen und verwalten zeigt, wie Sie die Datenbank anlegen.
Ein Beispiel mit erfundenen Werten.
set mysql_connection_string "mysql://u123_AbCdEfGh:Passwort123@203.0.113.20:3306/s123_db?charset=utf8mb4"
Die Verbindung aus OuiPanel einfügen
OuiPanel kann diese Zeile für Sie schreiben.
Klicken Sie im Seitenmenü auf FiveM-Konfiguration.
Klicken Sie in der Karte MySQL-Verbindung einfügen auf Datenbank auswählen.
Wählen Sie im Fenster „Datenbank auswählen“ die Datenbank und klicken Sie auf Bestätigen.
Das Panel fügt unter dem Block ### AUTOMATICALLY SET BY PTERODACTYL ### eine Zeile set mysql_connection_string ein. Eine bereits vorhandene Zeile wird auskommentiert.

Format Schlüssel=Wert
oxmysql akzeptiert die Zeichenkette auch als Schlüssel=Wert-Paare. Die erste Zeile ist das ältere Format, die zweite das Format, das OuiPanel schreibt.
set mysql_connection_string "server=203.0.113.20;uid=u123_AbCdEfGh;password=Passwort123;database=s123_db"
set mysql_connection_string "user=u123_AbCdEfGh;password=Passwort123;host=203.0.113.20;port=3306;database=s123_db"
Berechtigungskonfiguration (ACE/ACL)
Das ACE-System (Access Control Entry) verwaltet die Berechtigungen auf FiveM. Mehr dazu in der Anleitung Permissions ACE auf FiveM.
Einen Administrator hinzufügen
Ein Spieler wird Administrator, wenn Sie ihn der Gruppe group.admin hinzufügen. Am häufigsten nutzt man die Steam-Kennung.
add_principal identifier.steam:110000xxxxxxxxx group.admin
Über die Discord-Kennung.
add_principal identifier.discord:123456789012345678 group.admin
Über die Rockstar-Lizenzkennung.
add_principal identifier.license:xxxxxxxxxxxxxxxxxxxxx group.admin
Ihre Steam-Kennung finden Sie auf SteamID.io. Nötig ist die hexadezimale Form, die mit
110000beginnt.
Berechtigungsgruppen erstellen
# Admin-Gruppe mit allen Befehlen außer quit
add_ace group.admin command allow
add_ace group.admin command.quit deny
# Moderatorengruppe
add_ace group.moderator command.kick allow
add_ace group.moderator command.ban allow
# Die Admin-Gruppe erbt die Rechte der Moderatorengruppe
add_principal group.admin group.moderator
Häufige Berechtigungen
# Die Admin-Gruppe darf alle Befehle nutzen
add_ace group.admin command allow
# Einzelne Berechtigungen
add_ace group.admin command.restart allow
add_ace group.admin command.stop allow
add_ace group.admin command.start allow
add_ace group.admin command.refresh allow
# vMenu-Berechtigungen
add_ace group.admin vMenu.Everything allow
add_ace group.moderator vMenu.OnlinePlayers.Kick allow
add_ace group.moderator vMenu.OnlinePlayers.TempBan allow
Einen Spieler einer Gruppe zuweisen
add_principal identifier.steam:110000xxxxxxxxx group.admin
add_principal identifier.discord:123456789012345678 group.moderator
Netzwerkkonfiguration
Server-Port
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"
In OuiPanel gehören diese beiden Zeilen zum Block, den das Panel schreibt. Sie verwenden den Hauptport Ihres Servers, den Sie unter Konfiguration › Port-Verwaltung sehen. Ändern Sie sie nicht.
RCON (Fernkonsole)
rcon_password "SehrSicheresRconPasswort"
Mit RCON steuern Sie den Server aus der Ferne. Wählen Sie ein langes, einmaliges Passwort. Um RCON zu deaktivieren, lassen Sie den Wert mit rcon_password "" leer.
Steam-API-Schlüssel
FiveM verwendet steam_webApiKey laut seiner offiziellen Dokumentation seit dem 4. November 2026 nicht mehr. Lassen Sie die Variable Clé API Web Steam (obsolète) in OuiPanel auf none und tragen Sie sie nicht in server.cfg ein. Um ein Steam-Konto vorauszusetzen, nutzen Sie sv_enforceSteamAuth auf einem Server ab Build 38004, wie es die Anleitung ACE-Berechtigungen auf FiveM erklärt.
Gameplay-Konfiguration
PvP, Radar oder Passivmodus werden nicht in der server.cfg eingestellt. Sie hängen von Ihren Ressourcen und Ihrem Framework ab. Einige Einstellungen für das Gameplay stehen trotzdem in der Datei.
Spielversion (Game Build)
sv_enforceGameBuild 2944
Diese Zeile schreibt den Spielern eine Version von GTA V vor. So bleiben Ressourcen kompatibel, etwa Fahrzeuge oder Maps aus einem neuen Update.
| Build | Update von GTA V |
|---|---|
2060 | Los Santos Summer Special |
2189 | Cayo Perico Heist |
2372 | Los Santos Tuners |
2545 | The Contract |
2699 | The Criminal Enterprises |
2802 | Los Santos Drug Wars |
2944 | San Andreas Mercenaries |
3095 | The Chop Shop |
3258 | Bottom Dollar Bounties |
3407 | Agents of Sabotage |
3570 | Money Fronts |
3751 | A Safehouse in the Hills |
3889 | The Kortz Center Heist |
Im Kanal Enhanced von FiveM wird nur die neueste Spielversion unterstützt.
Script Hook und veränderte Dateien
# Weist Spieler mit Script Hook V ab (Standardwert)
sv_scriptHookAllowed 0
# Blockiert veränderte Spieldateien, außer Audio und bekannten Grafikmods
sv_pureLevel 1
Mit sv_pureLevel 2 werden alle veränderten Dateien blockiert. Cfx.re rät davon ab, Script Hook zu erlauben, weil das den Server angreifbar macht.
Nützliche Convars
Variablen festlegen
set meine_variable "wert"
setr meine_replizierte_variable "wert"
sets meine_serverinfo_variable "wert"
| Befehl | Sichtbarkeit |
|---|---|
set | Nur auf dem Server |
setr | An die Clients übertragen |
sets | In den Serverinformationen sichtbar |
Variablen des Frameworks ESX
setr esx:locale "de"
Diese Zeile legt die Sprache von ESX Legacy fest. Startgeld und weitere Einstellungen stehen in der Konfigurationsdatei von es_extended, nicht in der server.cfg.
Variablen des Frameworks QBCore
setr qb_locale "de"
Diese Zeile legt die Sprache von QBCore fest. Das Startgeld stellen Sie in qb-core/config.lua ein.
Vollständiges server.cfg-Beispiel
Hier eine vollständige server.cfg. Behalten Sie den Block, den OuiPanel schreibt, am Anfang Ihrer Datei.
# ============================================
# KONFIGURATION DES FIVEM-SERVERS
# ============================================
# === LIZENZ ===
sv_licenseKey "ihr_lizenzschluessel_hier"
# === IDENTITÄT DES SERVERS ===
sv_hostname "[DE] Mein RP-Server | Seriöses Roleplay"
sets sv_projectName "Mein RP-Server"
sets sv_projectDesc "Deutscher Roleplay-Server mit realistischer Wirtschaft und aktiver Community."
sets tags "roleplay, deutsch, serious, esx, economy"
load_server_icon server_icon.png
# === SPIELER ===
sv_maxclients 48
set onesync on
# === NETZWERK (Zeilen, die OuiPanel mit dem Hauptport schreibt) ===
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"
# === RCON ===
rcon_password ""
# === DATENBANK ===
set mysql_connection_string "mysql://user:password@host:3306/database?charset=utf8mb4"
# steam_webApiKey wird von FiveM seit dem 04.11.2026 nicht mehr verwendet
# === GAMEPLAY ===
sv_enforceGameBuild 2944
# ============================================
# ACE/ACL-BERECHTIGUNGEN
# ============================================
# Admin-Gruppe
add_ace group.admin command allow
add_ace group.admin command.quit deny
# Administratoren (durch Ihre Kennungen ersetzen)
# add_principal identifier.steam:110000xxxxxxxxx group.admin
# add_principal identifier.discord:123456789012345678 group.admin
# ============================================
# RESSOURCEN
# ============================================
# === FiveM-Grundlagen ===
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure hardcap
ensure rconlog
# === Datenbank ===
ensure oxmysql
# === Framework ESX ===
ensure es_extended
ensure esx_menu_default
ensure esx_menu_dialog
ensure esx_menu_list
# === ESX-Skripte ===
ensure esx_identity
ensure esx_society
ensure esx_billing
ensure esx_banking
ensure esx_skin
# === Berufe ===
ensure esx_policejob
ensure esx_ambulancejob
ensure esx_mechanicjob
# === Weitere Skripte ===
ensure esx_vehicleshop
ensure esx_property
# === Eigene Skripte ===
# ensure mein_skript
Fehlerbehebung
Der Server startet nicht
| Meldung | Lösung |
|---|---|
Invalid license key | Prüfen Sie den Schlüssel im Cfx.re-Portal und in der Variable fivem license |
License key not set | Füllen Sie die Variable fivem license oder die Zeile sv_licenseKey aus |
A valid license check is required to run this server | Meldung der Edition Enhanced. Tragen Sie Ihren eigenen Schlüssel in die Variable fivem license ein |
Command not found (sv_endpointprivacy) | In der Edition Enhanced gesehen, die diesen Befehl nicht kennt. Diese Meldung allein stoppt den Server nicht |
Could not find resource | Prüfen Sie, ob die Ressource im Ordner resources liegt |
MySQL connection failed | Prüfen Sie die MySQL-Verbindungszeichenkette |
Schreibt FXServer „Could not authenticate server license key“, öffnet die Konsole von OuiPanel das Fenster „FiveM-Lizenzschlüssel abgelehnt“. Die Schaltfläche Servereinstellungen öffnen führt direkt zur Variable, die Sie korrigieren müssen. Auf Enhanced lautet die Meldung anders, und dieses Fenster öffnet sich nicht.
Der Server erscheint nicht in der Liste
| Ursache | Lösung |
|---|---|
| Ungültiger Lizenzschlüssel | Erzeugen Sie im Cfx.re-Portal einen neuen Schlüssel |
Zeilen endpoint verändert | Setzen Sie den Hauptport aus der Port-Verwaltung wieder ein |
| Server startet noch | Warten Sie einige Minuten |
Eine Ressource lädt nicht
| Ursache | Lösung |
|---|---|
| Fehlende Abhängigkeit | Installieren Sie die Abhängigkeiten, die der Autor angibt |
| Fehler im Skript | Lesen Sie die Serverkonsole oder die Spielkonsole mit F8 |
| Falsche Ladereihenfolge | Ordnen Sie die ensure-Zeilen neu |
fxmanifest.lua fehlt | Prüfen Sie, ob die Datei im Ordner der Ressource liegt |
Datenbankfehler
| Meldung | Lösung |
|---|---|
Access denied | Prüfen Sie MySQL-Benutzer und Passwort |
Unknown database | Legen Sie die Datenbank an |
Connection refused | Prüfen Sie Host und Port |
ACE-Berechtigungen greifen nicht
| Ursache | Lösung |
|---|---|
| Falsche Kennung | Prüfen Sie das Präfix (steam:, discord:, license:) |
| Server nicht neu gestartet | Starten Sie nach jeder Änderung neu |
| Tippfehler | Prüfen Sie die Syntax jeder Zeile |
Brauchen Sie Hilfe?
Eröffnen Sie ein Ticket über Tickets › Ticket öffnen oder über die Kachel Support kontaktieren unten auf der Seite Ihres Servers im Kundenbereich. Sie können Ihre Frage auch auf dem Discord von OuiHeberg stellen.
Entdecken Sie unsere GTA V / FiveM-Hosting-Angebote ab 2,99 €/Monat, Server in 60 Sekunden bereit.
Angebote ansehen →