So richtest du txAdmin auf deinem FiveM-Server ein

Dein Server wird mit laufendem txAdmin bereitgestellt und der Gameserver bewusst zurückgehalten. Fünf Schritte im Assistenten bringen ihn online, und einer davon, die Datenbankverbindung, ist der Punkt, an dem fast alle stehen bleiben, weil ihre Felder hinter einem Button versteckt sind. Der Button und die Werte stehen auf dieser Seite.

Zuerst: Ein Offline-Server ist hier normal

Ein frisches FiveM-Deployment startet txAdmin und sonst nichts. Der Spielport bleibt absichtlich still, bis du den Admin-Account übernommen, einen Lizenzschlüssel eingetragen und einen Server-Build gewählt hast, denn ein FiveM-Server ohne all das kann nicht starten. In den ersten Minuten nach dem Bereitstellen ist es also der erwartete Zustand und kein Fehler, wenn dein Dashboard den Server als noch nicht spielbereit zeigt.

Das Dashboard sagt es auch: Die Server-Karte wird bernsteinfarben mit Aktion nötig: Einrichtung in txAdmin abschließen, und wenn du sie öffnest, bekommst du den txAdmin-Link und die unten beschriebene PIN. Nichts auf dieser Seite braucht ein Support-Ticket.

Die fünf Schritte

1. txAdmin öffnen

Du musst keine Adresse suchen. In deinem Dashboard öffnet das bernsteinfarbene Banner auf der Server-Karte ein Panel mit einem txAdmin öffnen-Button, und derselbe Button sitzt auf dem Tab „Spieler“, sobald du auf „Verwalten“ klickst. Er zeigt auf die eigene txAdmin-Domain deines Servers, die auch nach einem Failover weiter funktioniert, weil sie immer auf die Instanz auflöst, die gerade Primary ist. Deshalb verlinken wir sie, statt eine Node-IP auszugeben: Eine IP stimmt, bis sie es nicht mehr tut.

2. Den Admin-Account mit der PIN übernehmen

Beim ersten Start fragt txAdmin nach einer PIN, die nur in der Serverkonsole ausgegeben wird, und bittet dich dann, einen Master-Admin-Benutzernamen und ein Passwort für das Panel selbst anzulegen. Auf einem Managed-Server siehst du diese Konsole normalerweise nicht, daher liest das Dashboard die PIN aus dem Container-Log und zeigt sie im selben Panel wie den txAdmin-Button an, kopierbereit.

Der Master-Admin-Login ist nicht dein Flux-Konto, nicht dein Cfx.re-Konto und nicht das Datenbank-Passwort. Er ist eine dritte Zugangsdatenkombination, er ist der Weg zurück in dein Panel, und niemand kann ihn für dich zurücksetzen. Speichere ihn, bevor du weitermachst. Ist die PIN abgelaufen, wenn du sie nutzt, starte den Server im Dashboard neu, dann wird eine frische ausgegeben.

3. Einen Server-Build wählen

Der Assistent bietet dann ein Recipe oder einen bestehenden Server an. Ein Recipe wie qbcore, qbox oder ESX lädt das Framework, seine Resources und sein SQL-Schema herunter und importiert das Schema in deine Datenbank, was der schnellste Weg zu einem funktionierenden Roleplay-Server ist. Wähle eines, und txAdmin zeigt es auf einem Bildschirm namens Schritt 1: Recipe prüfen. Mach weiter, und du erreichst Schritt 2: Eingabeparameter, wo die nächsten beiden Schritte stattfinden.

4. Deinen cfx.re-Lizenzschlüssel hinzufügen

Das erste Feld bei den Eingabeparametern ist Server Registration Key. Erzeuge unter portal.cfx.re einen kostenlosen und füge den cfxk_-Wert ein. Der Schlüssel wird auf dein Konto ausgestellt und nicht auf unseres, deshalb kannst du den Server mitnehmen; das Deployment setzt NO_LICENSE_KEY=1, damit er hier angegeben wird, statt in die App eingebacken zu sein. Wenn du den Schlüssel jemals neu erzeugst, kannst du ihn später ändern, ohne den Assistenten erneut zu durchlaufen: Es ist ein Feld im Tab „Server Settings“ des Management-Panels.

5. Die Datenbank-Optionen öffnen und die Datenbank verbinden

Dieser Schritt verursacht die meisten Support-Tickets, weil die Datenbankfelder versteckt sind. Direkt unter dem Schlüssel gibt es einen grauen Button, Show/Hide Database options (advanced). Klick darauf. Erst dann erscheinen die Felder Database Host, Port, Username, Password und Name. Überspringst du den Button, läuft das Recipe mit den Standardwerten von txAdmin und die Datenbankverbindung schlägt fehl.

Die Felder sind vorausgefüllt, mit localhost als Host und 3306 als Port. Diese Standardwerte sind auf diesem Server falsch. Ersetze den Inhalt jedes Feldes durch diese Werte:

FeldWert
Hostoperator
Port3307
Usernameroot
PasswordMYSQL_ROOT_PASSWORD
Databasefivem

Host ist der Sync-Operator und nicht der Datenbank-Container, das Passwort ist das, das du beim Bereitstellen gewählt hast, und die Datenbank selbst wird leer für dich angelegt, bevor der Server startet.

Das Passwort liegt im Management-Panel unter Deployment-Einstellungen als MYSQL_ROOT_PASSWORD, mit einem Anzeigen-Button und einem Kopieren-Button. Das Panel zeigt außerdem diese vier festen Werte auf einer Karte daneben an, sodass du sie direkt in txAdmin kopieren kannst, ohne hierher zurückzukommen.

Zwei Vermutungen sind erwähnenswert, weil beide falsch sind und beide richtig aussehen. Host ist nicht localhost: txAdmin und die Datenbank sind getrennte Container. Host ist auch nicht mariadb, obwohl es eine Komponente mit diesem Namen gibt. Alles läuft über den Operator, der jeden Schreibvorgang auf die anderen Instanzen repliziert; direkt in eine MariaDB zu schreiben würde deine Stadt desynchronisieren und sie bei einem Failover verlieren.

Dann führe das Recipe aus. txAdmin lädt das FiveM-Artifact herunter, importiert das Schema, schreibt die server.cfg und startet den Server, und dein Dashboard wird innerhalb weniger Minuten grün. Hast du statt eines Recipes einen bestehenden Server gewählt, gibt es keine Datenbankfelder auszufüllen: Setze die Verbindung in deiner server.cfg, wie in den Fragen unten gezeigt.

Wenn txAdmin sagt, dass es sich nicht verbinden kann

Prüfe zuerst Host und Port, denn localhost und mariadb sind die häufigen Vermutungen, und keine funktioniert. Wenn die stimmen, liegt es an einem Passwort-Konflikt. Die Datenbank wird mit MYSQL_ROOT_PASSWORD bereitgestellt und der Operator authentifiziert sich mit DB_INIT_PASS, und beide müssen identisch sein, damit die Datenbank überhaupt initialisiert. Das Panel hält sie genau deshalb verknüpft: Wenn du eines bearbeitest, wird das andere umgeschrieben, und das Feld ist als verknüpft markiert, damit das Verhalten nicht wie ein Formular wirkt, das deine Eingabe ablehnt. Was du in txAdmin eingibst, muss genau dieser Wert sein.

Später wieder hineinkommen

Nach dem Assistenten ist txAdmin das Alltagspanel: Live-Konsole, Resources, Bans, der CFG-Editor und geplante Neustarts. Der gleiche Button „txAdmin öffnen“ bringt dich dorthin, und du meldest dich mit dem Master-Admin-Account aus Schritt 2 an. Das Dashboard behält die darunterliegende Ebene: Neustarts und Redeploys, den Datei-Browser, Hardware, den Datenbankzustand über die Nodes hinweg und Backups.

Noch nicht bereitgestellt?

txAdmin auf einer eigenen Adresse, die Datenbank angelegt und verbunden, bevor die erste Resource lädt, und beide Ports veröffentlicht, ohne dass du eine Firewall anfassen musst. Die erste Woche ist kostenlos, wenn dein Flux-Konto neu ist.

Häufig gestellte Fragen

Was gebe ich in den txAdmin-Datenbankeinstellungen ein?

Klicke zuerst auf der Eingabeparameter-Seite unter dem Registrierungsschlüssel auf „Show/Hide Database options (advanced)“, denn die Felder sind erst danach sichtbar. Ersetze dann die vorausgefüllten Werte durch Host operator, Port 3307, Benutzername root, Datenbank fivem und das MYSQL_ROOT_PASSWORD, das du beim Bereitstellen gewählt hast. txAdmin findet den Operator nicht von selbst. Das Passwort wird in den Deployment-Einstellungen im Management-Panel angezeigt und kopiert.

Warum ist mein FiveM-Server direkt nach dem Bereitstellen offline?

Weil er noch nicht eingerichtet wurde, und das ist so gewollt. Das Deployment läuft ohne Standardkonfiguration und ohne Lizenzschlüssel, daher startet txAdmin auf seiner eigenen Adresse, und der Spielport bleibt still, bis du den Admin-Account übernommen, deinen cfx.re-Schlüssel hinzugefügt und einen Server-Build bereitgestellt hast. Er geht ein paar Minuten nach Abschluss des Assistenten online.

Wo finde ich die txAdmin-PIN?

In deinem Dashboard. txAdmin gibt sie nur in der Serverkonsole aus, daher liest das Dashboard sie aus dem Container-Log und zeigt sie kopierbereit neben dem Button „txAdmin öffnen“ an. Ist sie abgelaufen, starte den Server neu, dann wird eine neue ausgegeben.

Kann ich mich stattdessen direkt mit MariaDB verbinden?

Nein, und es lohnt sich zu wissen, warum. Jeder Schreibvorgang muss über den Operator auf Port 3307 laufen, der ihn auf deine anderen Instanzen repliziert. Wenn du etwas direkt auf einen MariaDB-Container zeigen lässt, schreibt es nur auf eine Maschine, und genau diese Daten verlierst du, wenn der Primary das nächste Mal wechselt.

Muss ich ein Recipe wie qbcore oder ESX verwenden?

Nein. Ein Recipe ist der schnellste Weg, weil es das SQL-Schema des Frameworks für dich in deine Datenbank importiert, aber die leere Option gibt es für alle, die einen bestehenden Build mitbringen. Du kannst in beiden Fällen Resources über den Datei-Browser hochladen und danach einen SQL-Dump importieren.

Keine Resource kann die Datenbank erreichen: „mysql_connection_string structure was invalid“

Dein Datenbank-Passwort enthält ein Zeichen, das in einer URL prozentkodiert werden muss, etwa @, % oder ^, daher ist der mysql://-String, den oxmysql baut, kein gültiger URI und nichts verbindet sich. Du musst weder das Passwort ändern noch etwas neu bauen: Trage stattdessen die Semikolon-Form in die server.cfg ein, denn sie wird wörtlich gelesen und nicht als URL geparst. Nutze set mysql_connection_string "server=operator;port=3307;user=root;password=YOUR_PASSWORD;database=fivem" mit dem Passwort aus den Deployment-Einstellungen und starte neu. Von hier bereitgestellte Server bekommen jetzt ein URL-sicheres Passwort, das betrifft also nur ältere, und das Dashboard markiert sie auf der Server-Karte mit beiden Lösungen: dieser und einem geführten Neu-Erzeugen und Neu-Aufbauen für eine Installation ohne erhaltenswerte Daten.

Das Recipe wird nicht fertig: „Duplicate entry ‘1’ for key ‘PRIMARY’“

Die Datenbank ist von einer früheren Installation bereits befüllt, daher kollidieren die Seed-Daten des Recipes mit dem, was dort liegt. Das „Delete Database“ von txAdmin räumt sie oft nicht auf, weil es den Sync-Operator nicht berührt. Öffne den Server in deinem Dashboard und nutze den Button „Datenbank zurücksetzen“ im Panel-Header: Er leert die Datenbank auf allen deinen Nodes und behält Serverdateien und txAdmin-Einrichtung, sodass du das Recipe sauber neu ausführen kannst. Er löscht alle Spieldaten. Normalerweise ist das eine Installation, die noch nichts gespeichert hat, aber wenn du Daten hast, erstelle zuerst einen SQL-Dump (das eigene Backup des Sync-Operators), denn das Volume-Backup kann eine laufende Datenbank nicht wiederherstellen.

Ich habe das Master-Admin-Passwort von txAdmin verloren. Könnt ihr es zurücksetzen?

Nicht von unserer Seite: Dieser Account lebt in txAdmin auf deinem Server und nicht in unserer Abrechnung oder unserem Dashboard, wir haben also nichts zurückzusetzen. Er lässt sich vom Server selbst wiederherstellen, und das Management-Panel gibt dir die Konsole und den Datei-Browser, die du dafür brauchst. Öffne ein Support-Ticket, dann führen wir dich durch, denn es ist kein Grund, neu zu deployen und die Stadt zu verlieren.

Weiterlesen