HZ Scripts
server setup

txAdmin Setup Guide 2026: Installieren, Konfigurieren und Verwalten deines FiveM Servers

HitzyMay 26, 202610 min read
txadminfivemfivem serverserver managementserver setup

txAdmin Setup Guide 2026: Installieren, Konfigurieren und Verwalten deines FiveM Servers

Wenn du einen FiveM Server einrichtest, wirst du viel Zeit in txAdmin verbringen. Es ist das webbasierte Verwaltungspanel, das alles uebernimmt -- vom Starten deines Servers bis zum Bannen toxischer Spieler. Es gut zu kennen, wird dir stundenlange Fehlersuche ersparen.

Dieser Guide deckt alles ab -- von deinem ersten txAdmin-Start bis zur fortgeschrittenen Konfiguration: automatische Neustarts, Backups, Ressourcenverwaltung und Admin-Berechtigungen.

Wenn du noch keinen FiveM Server eingerichtet hast, starte mit unserem Kompletten Einsteiger-Guide zum Erstellen eines FiveM Servers.


Inhaltsverzeichnis

  1. Was ist txAdmin?
  2. txAdmin installieren (Windows & Linux)
  3. Ersteinrichtungs-Assistent
  4. Das txAdmin-Dashboard verstehen
  5. server.cfg ueber txAdmin konfigurieren
  6. Ressourcen verwalten
  7. Spieleradministration
  8. Automatische Neustarts und Backups
  9. Admin-Berechtigungen und Rollen
  10. Haeufige Probleme beheben
  11. FAQ

Was ist txAdmin?

txAdmin ist das offizielle Server-Verwaltungspanel fuer FiveM. Es wird vom CFX.re-Team entwickelt und ist in jedem FiveM-Server-Build enthalten.

Es bietet eine webbasierte Oberflaeche (erreichbar unter http://DEINE_IP:40120), mit der du:

  • Deinen Server mit einem Klick starten, stoppen und neustarten kannst
  • Die Live-Serverkonsole im Browser nutzen kannst
  • server.cfg mit Syntax-Highlighting bearbeiten kannst
  • Einzelne Ressourcen durchsuchen, starten und stoppen kannst
  • Spieler bannen, kicken und verwarnen kannst
  • Geplante Neustarts und automatische Backups einrichten kannst
  • Mehrere Admin-Konten mit rollenbasierten Berechtigungen verwalten kannst
  • Servermetriken (CPU, RAM, Spielerzahl) in Echtzeit einsehen kannst
Ohne txAdmin wuerdest du deinen Server ueber reine Konsolenbefehle verwalten -- moeglich, aber muehsam. txAdmin ist der Standard.

txAdmin installieren

txAdmin ist im FiveM-Server vorinstalliert. Du installierst txAdmin nicht separat -- du laedst den FiveM-Server-Build herunter, und txAdmin startet automatisch.

Windows-Installation

  1. Installiere Git und 7-Zip, falls noch nicht vorhanden.
  2. Gehe zur offiziellen FiveM-Artifacts-Seite: runtime.fivem.net/artifacts/fivem/build_server_windows/master/
  3. Lade den neuesten "recommended" Build herunter (achte auf das gruene Tag) -- es ist ein .7z-Archiv.
  4. Entpacke server.7z in einen Ordner (z.B. C:\FXServer\server).
  5. Fuehre FXServer.exe aus -- txAdmin startet automatisch und oeffnet deinen Browser.
  6. Gib die in der Konsole angezeigte PIN ein, klicke auf Link Account und authentifiziere dich mit deinem CFX.re-Konto.

Linux-Installation

Fuer den Produktionsbetrieb wird Linux empfohlen (bessere Performance, einfacher aktualisierbar, geringerer Speicherverbrauch).

# Voraussetzungen
sudo apt install git xz-utils

Dedizierten Benutzer erstellen

sudo adduser fivem sudo su - fivem

FXServer herunterladen

mkdir -p ~/FXServer/server cd ~/FXServer/server

Ersetze LATEST_LINK durch die aktuelle URL von der Artifacts-Seite

wget https://runtime.fivem.net/artifacts/fivem/build_proot_linux/master/LATEST_LINK tar xf fx.tar.xz --strip-components=1 rm fx.tar.xz

FXServer starten

bash run.sh +exec server.cfg

Ersetze LATEST_LINK durch die tatsaechliche Download-URL von der Linux-Artifacts-Seite. Waehle den neuesten empfohlenen Build.

Nach dem Start siehst du dieselbe txAdmin-URL. Oeffne sie in deinem Browser.

Hinweis zum Betrieb von txAdmin hinter einem Reverse Proxy

Wenn du eine saubere URL wie panel.deinserver.com statt deine-ip:40120 moechtest, richte Nginx oder Caddy als Reverse Proxy ein. Damit kannst du auch HTTPS ueber Let's Encrypt aktivieren. Empfohlen fuer jeden oeffentlich zugaenglichen Server.


Ersteinrichtungs-Assistent

Beim ersten Start fuehrt dich txAdmin durch einen 4-Schritte-Assistenten.

Schritt 1 -- Master-Admin-Konto erstellen

Du erstellst das primaere Admin-Konto fuer txAdmin. Dieses Konto hat volle Berechtigungen ueber das Panel. Waehle ein starkes Passwort -- jeder mit diesem Login kontrolliert deinen gesamten Server.

Du kannst dich auch ueber dein Discord- oder CFX.re-Konto per OAuth anmelden. Empfohlen fuer die Sicherheit (kein Passwort, das geleakt werden kann).

Schritt 2 -- CFX.re-Konto verknuepfen

txAdmin bittet dich, es mit deinem CFX.re-Konto zu autorisieren. Dies verbindet deinen Server mit deinem CFX.re-Lizenzschluessel, damit er sich korrekt authentifizieren kann.

Schritt 3 -- Server-Konfiguration

Du wirst nach Folgendem gefragt:

  • Servername (z.B. "Mein Grossartiger RP Server")
  • Server-Ordner -- wo deine resources/ und server.cfg liegen werden
  • Server-Datenpfad -- wo txAdmin seine Daten speichert (Logs, Backups usw.)

Schritt 4 -- Rezept waehlen (oder ueberspringen)

Das ist die grosse Entscheidung: Soll txAdmin automatisch einen Basisserver installieren, oder moechtest du von Grund auf starten?

Waehle "Popular Recipes", um verfuegbare Vorlagen zu sehen. Die Liste variiert im Laufe der Zeit, aber typische Optionen umfassen:

  • CFX Default FiveM -- minimales Standard-Setup, keine Datenbank erforderlich. Am besten zum ersten Experimentieren.
  • QBCore -- vollstaendiges QBCore-Framework + essentielle Scripts. Erfordert MariaDB.
  • ESX Legacy -- vollstaendiges ESX-Framework + essentielle Scripts. Erfordert MariaDB.
  • QBox -- vollstaendiges QBox-Framework. Erfordert MariaDB.
Einige Community-Rezepte (vMenu, eigene Vorlagen) koennen ebenfalls verfuegbar sein. Unsere Empfehlung: Wenn du ein absoluter Anfaenger bist und nur experimentierst -- nutze CFX Default FiveM (keine Datenbank noetig). Wenn du einen ernsthaften RP-Server aufbaust -- waehle ein QBCore- oder QBox-Rezept, oder starte mit einem leeren Setup und installiere alles manuell. Du wirst deinen Stack viel besser verstehen, was sich beim Debuggen um 2 Uhr nachts auszahlt.

Nach diesem Schritt schliesst txAdmin die Einrichtung ab und startet deinen Server. Du solltest "Server started" in der Konsole sehen.


Das txAdmin-Dashboard verstehen

Sobald du angemeldet bist, siehst du das txAdmin-Haupt-Dashboard. Lass uns die einzelnen Bereiche durchgehen.

Kopfleiste

Die obere Leiste zeigt:


  • Serverstatus (Online/Offline mit Spielerzahl)

  • Server-Betriebszeit

  • CPU- und RAM-Auslastung

  • Schnellaktions-Buttons (Server starten, stoppen, neustarten)


Linke Seitenleiste

  • Dashboard -- Uebersichtsmetriken und Schnellaktionen
  • Players -- verbundene Spieler + Datenbank aller Spieler
  • History -- Admin-Aktionsverlauf (Bans, Kicks, Verwarnungen)
  • Whitelist -- falls Whitelist aktiviert ist
  • Resources -- einzelne Scripts starten/stoppen/neustarten
  • Server Log -- Echtzeit-Konsolenausgabe
  • Server.cfg Editor -- Haupt-Config-Datei mit Syntax-Highlighting bearbeiten
  • txAdmin Settings -- das Panel selbst konfigurieren

Live-Konsole

Die Live-Konsole ist der Ort, an dem du die meiste Debugging-Zeit verbringen wirst. Sie zeigt die Echtzeit-Serverausgabe: Chat-Nachrichten, Fehler, Ressourcen-Warnungen, Spielerverbindungen.

Du kannst Serverbefehle direkt in die Konsole eingeben -- alles, was du per SSH eingeben wuerdest, funktioniert hier. Beispiele:

ensure hz-weather     # eine Ressource starten
restart hz-weather    # eine Ressource neustarten
stop hz-weather       # eine Ressource stoppen
status                    # Serverstatus anzeigen
players                   # verbundene Spieler auflisten
quit                      # Server stoppen

server.cfg ueber txAdmin konfigurieren

Deine server.cfg ist das Herzstuck deines FiveM Servers. Sie steuert Hostname, Slot-Anzahl, Lizenzschluessel, Admin-Berechtigungen und welche Ressourcen gestartet werden.

Der integrierte Editor von txAdmin bietet Syntax-Highlighting und einen "Save & Restart"-Button.

Essentielle server.cfg-Einstellungen

Hier ist eine minimale server.cfg fuer den Einstieg:

# Lizenzschluessel von portal.cfx.re
sv_licenseKey "your-key-here"

Server-Identitaet

sv_hostname "^1Mein ^7Toller ^2RP Server" sv_projectName "MeinServer" sv_projectDesc "Eine freundliche RP-Community" sv_maxClients 48

Endpoint-Einstellungen

endpoint_add_tcp "0.0.0.0:30120" endpoint_add_udp "0.0.0.0:30120"

Server-Tags (fuer den FiveM-Browser)

sets tags "roleplay, qbcore, custom" sets locale "en-US"

Datenbankverbindung (MariaDB -- fuer ESX/QBCore/QBox)

set mysql_connection_string "mysql://user:password@localhost/dbname?charset=utf8mb4"

OneSync (erforderlich fuer serverseitige Spielererkennung)

set onesync on

Ressourcen -- Reihenfolge ist wichtig

ensure oxmysql ensure ox_lib ensure qb-core ensure pma-voice ensure hz-weather ensure hz-television

... weitere Ressourcen hier hinzufuegen

Reihenfolge der Ressourcen

Ressourcen werden in der Reihenfolge geladen, in der sie in der server.cfg stehen. Abhaengigkeiten muessen zuerst kommen.

Gaengige Reihenfolge:


  1. Datenbank (oxmysql -- der moderne Standard, ersetzt mysql-async)

  2. Bibliotheken (ox_lib, PolyZone)

  3. Framework-Kern (es_extended, qb-core, qbx_core)

  4. Framework-Module (Jobs, Banking, Inventar)

  5. Standalone-Scripts (HZ-Scripts, Wetter, TVs, Audio usw.)

  6. Zuletzt (Admin-Tools, optionale Mods)


Wenn du ein Script vor seiner Abhaengigkeit mit ensure laedt, siehst du Startfehler. Das sorgfaeltige Lesen der Konsole verrraet dir, was fehlt.


Ressourcen verwalten

Der Resources-Tab in txAdmin listet jede Ressource in deinem resources/-Ordner auf, mit Status (gestartet/gestoppt) und Startzeit.

Starten/Stoppen/Neustarten ueber das Panel

Klicke auf eine beliebige Ressource und nutze die Buttons:

  • Start -- entspricht ensure resource_name
  • Stop -- entspricht stop resource_name
  • Restart -- Stoppen und dann Starten
Das Neustarten einer einzelnen Ressource ist viel schneller als ein Neustart des gesamten Servers. Nutze dies staendig waehrend der Entwicklung.

Ressourcenliste aktualisieren

Wenn du einen neuen Ressourcen-Ordner in resources/ ablegst und er nicht im Panel erscheint, klicke auf "Refresh". Dies scannt den Ordner erneut.

Haeufige Ressourcen-Fehler

Die meisten Ressourcen-Fehler werden in der Konsole mit [ERROR]- oder [WARN]-Tags angezeigt:

  • Could not find dependency -- eine benoetigte Ressource laeuft nicht. Pruefe die Dokumentation der Ressource auf ihre Anforderungen (oft ox_lib, oxmysql).
  • Script error: attempt to index a nil value -- Lua-Script-Fehler. Lies die Zeilennummer, oeffne die Datei, untersuche das Problem.
  • oxmysql: no connection -- deine MariaDB/MySQL-Zugangsdaten in der server.cfg sind falsch oder die Datenbank laeuft nicht.

Spieleradministration

Der Players-Tab zeigt alle aktuell verbundenen Spieler sowie eine durchsuchbare Datenbank aller Spieler, die jemals beigetreten sind.

Schnellaktionen pro Spieler

Rechtsklicke auf einen Spieler, um:


  • Kick (mit Begruendung)

  • Warn (wird in der Historie gespeichert)

  • Ban (temporaer oder permanent)

  • DM (direkte In-Game-Nachricht)

  • Spectate (Gameplay beobachten)

  • Teleport (Admin-Werkzeug)


Bans

txAdmin-Bans speichern die Lizenz, IP, Hardware-ID, Steam-, Discord- und Xbox-Live-Kennungen des Spielers. Ein gebannter Spieler kann nicht zurueckkehren, indem er einfach seine IP oder sein Steam-Konto aendert -- es sei denn, er faelscht seine gesamte Hardware-ID.

Fuer maximale Effektivitaet fuehre Bans ueber txAdmin aus (nicht ueber In-Game-Chat-Befehle), damit sie in der txAdmin-Datenbank gespeichert werden.


Automatische Neustarts und Backups

Zwei Funktionen, die jeder Server aktivieren muss: geplante Neustarts und automatische Backups.

Geplante Neustarts

FiveM Server sammeln langsam Speicher an. Ein sauberer Neustart alle 6-12 Stunden haelt die Performance stabil.

Unter Settings -- Restarter:


  • Aktiviere "Scheduled Restarts"

  • Setze Neustartzeiten (z.B. 06:00, 18:00 Serverzeit)

  • Konfiguriere Warnungen: txAdmin sendet In-Game-Nachrichten 30, 15, 5 Minuten vor dem Neustart


Automatische Backups

txAdmin kann deinen server-data-Ordner + MariaDB-Datenbank nach einem Zeitplan sichern.

Unter Settings -- Backup:


  • Aktiviere "Auto Backup"

  • Setze die Haeufigkeit (taeglich empfohlen)

  • Setze die Aufbewahrungsdauer (7-14 Tage an Backups aufbewahren)

  • Gib das Backup-Ziel an (lokaler Ordner oder S3-kompatibler Speicher)


Konfiguriere MariaDB-Backups separat ueber deinen Hosting-Anbieter oder mit einem eigenen mariadb-dump-Cronjob. txAdmin sichert die Datenbank standardmaessig nicht automatisch.


Admin-Berechtigungen und Rollen

txAdmin verwendet ein rollenbasiertes Berechtigungssystem. Die Standardrollen:

  • Owner -- voller Zugriff auf alles (der initiale Admin)
  • Admin -- kann Spieler verwalten, Ressourcen neustarten, server.cfg bearbeiten
  • Moderator -- kann Spieler kicken/bannen, Logs einsehen, aber keine Serverkonfiguration aendern
  • Benutzerdefinierte Rollen -- du kannst eigene definieren

Neue Admins hinzufuegen

Unter Settings -- Admin Management:


  1. Klicke auf "Add Admin"

  2. Gib den Benutzernamen/die E-Mail ein

  3. Weise eine Rolle zu

  4. Der neue Admin erhaelt einen Einladungslink zum Setzen des Passworts


Discord OAuth (empfohlen)

Admin-Konten mit Discord OAuth zu verknuepfen ist sicherer als Passwoerter:


  • Keine Passwoerter, die geleakt werden koennen

  • Einfacherer Widerruf (einfach aus Discord entfernen)

  • Bessere Nachverfolgbarkeit (Discord-Benutzernamen in Logs)


Richte dies unter Settings -- Authentication ein.


Haeufige Probleme beheben

Server startet nicht

Symptom: txAdmin meldet "Server start failed" oder haengt beim Start. Ursachen:
  • Ungueltiger sv_licenseKey -- pruefe ihn auf portal.cfx.re
  • Port-Konflikt -- ein anderer Prozess nutzt Port 30120
  • Ressourcen-Absturz beim Laden -- pruefe die Konsole auf die zuletzt geladene Ressource
Loesung: Starte mit einer minimalen server.cfg (keine Ressourcen ausser mapmanager, chat, spawnmanager). Fuege Ressourcen einzeln zurueck, bis du den Verursacher findest.

txAdmin-Webpanel nicht erreichbar

Symptom: http://deine-ip:40120 laedt nicht. Ursachen:
  • Firewall blockiert Port 40120
  • txAdmin laeuft nicht (Server nicht gestartet)
  • Falsche IP
Loesung: Verbinde dich per SSH mit deinem Server, pruefe netstat -tulpn | grep 40120 (Linux), um zu bestaetigten, dass txAdmin laeuft. Oeffne den Port in deiner Firewall (ufw allow 40120/tcp unter Ubuntu).

Spieler koennen sich nicht verbinden

Symptom: Spieler erhalten "Couldn't load resource"- oder "Connection lost"-Fehler. Ursachen:
  • Eine Ressource konnte nicht geladen werden -- pruefe die Konsole auf [ERROR]
  • Server ist ueberlastet -- pruefe sv_maxClients
  • GTA V des Spielers ist veraltet -- sage ihm, er soll aktualisieren
Loesung: Lies die Serverkonsole, wenn der Spieler versucht, sich zu verbinden. txAdmin zeigt dir genau, welcher Schritt fehlgeschlagen ist.

MariaDB-Verbindungsfehler

Symptom: oxmysql: connection refused oder Access denied. Ursachen:
  • Falscher Connection-String in der server.cfg
  • MariaDB-Server laeuft nicht
  • Falsche Benutzerberechtigungen
Loesung: Teste deine Zugangsdaten mit HeidiSQL (bei MariaDB unter Windows mitgeliefert) oder DBeaver. Wenn sie dort funktionieren, liegt das Problem an der Syntax deiner server.cfg.

Wie geht es weiter?

Jetzt, wo du txAdmin in- und auswendig kennst:

  1. Waehle dein Framework mit Bedacht -- ESX vs QBCore vs QBox Vergleich
  2. Waehle deine ersten Scripts -- Erste Scripts fuer deinen FiveM Server
  3. Stelle deinen Script-Katalog zusammen -- stoebre bei HZ-Scripts nach Premium Plug-and-Play-Ressourcen
txAdmin ist das am meisten unterschaetzte Element des FiveM-Oekosystems. Meistere es frueh -- du wirst dir selbst danken, wenn du um 2 Uhr nachts einen 64-Spieler-Server debuggst, waehrend ein Discord-Raid fragt "Ist er schon wieder da?"

FAQ

Lies die FAQ-Abschnitte oben oder stoebre in unseren verwandten Guides fuer spezifische Themen.

Frequently Asked Questions