Hoe stel je txAdmin in op je FiveM-server

Je server wordt gedeployd met txAdmin dat draait en de gameserver bewust tegengehouden. Vijf stappen in de wizard brengen hem online, en één daarvan, de databaseverbinding, is waar bijna iedereen stopt, omdat de velden achter een knop verborgen zijn. De knop en de waarden staan op deze pagina.

Eerst: een offline server is hier normaal

Een verse FiveM-deploy start alleen txAdmin en verder niets. De gamepoort blijft bewust stil totdat je het admin-account hebt geclaimd, een licentiesleutel hebt toegevoegd en een serverbuild hebt gekozen, omdat een FiveM-server zonder die drie niet kan starten. Dus de eerste paar minuten na het deployen is het dashboard dat de server als nog niet accepterend spelers toont de verwachte staat en geen storing.

Het dashboard zegt het al: de servertegel wordt oranje met Actie vereist: rond de installatie af in txAdmin, en als je erop klikt krijg je de txAdmin-link en de PIN die hieronder wordt beschreven. Niets op deze pagina vereist een supportticket.

De vijf stappen

1. Open txAdmin

Je hoeft geen adres te zoeken. In je dashboard opent de oranje banner op de servertegel een paneel met een Open txAdmin-knop, en dezelfde knop staat op het tabblad Players zodra je op Manage klikt. Hij verwijst naar het eigen txAdmin-domein van je server, dat blijft werken na een failover omdat het altijd resolvet naar de instantie die momenteel primary is. Daarom linken we ernaar in plaats van een node-IP af te drukken: een IP is correct tot de dag dat hij dat niet meer is.

2. Claim het admin-account met de PIN

Bij de eerste keer opstarten vraagt txAdmin om een PIN die hij alleen naar de serverconsole print, en vraagt je daarna een hoofdbeheerdersgebruikersnaam en wachtwoord voor het paneel zelf aan te maken. Op een managed server zie je die console normaal gesproken niet, dus het dashboard leest de PIN uit het containerlogboek en toont hem in hetzelfde paneel als de txAdmin-knop, klaar om te kopiëren.

De master admin-login is niet je Flux-account, niet je Cfx.re-account en niet het databasewachtwoord. Het is een derde inloggegeven, het is de weg terug naar je paneel, en niemand kan het voor je resetten. Bewaar het voordat je verder gaat. Als de PIN verlopen is tegen de tijd dat je hem gebruikt, herstart je de server vanuit het dashboard en wordt er een nieuwe afgedrukt.

3. Kies een serverbuild

De wizard biedt daarna een recipe of een bestaande server aan. Een recipe zoals qbcore, qbox of ESX downloadt het framework, zijn resources en zijn SQL-schema en importeert het schema in je database, wat de snelste route naar een werkende roleplayserver is. Kies er een en txAdmin toont die op een scherm genaamd Stap 1: recipe controleren. Ga door, en je komt bij Stap 2: invoerparameters, waar de volgende twee stappen gebeuren.

4. Voeg je cfx.re-licentiesleutel toe

Het eerste veld op Input Parameters is Serverregistratiesleutel. Genereer er gratis een op portal.cfx.re en plak de cfxk_-waarde. De sleutel is uitgegeven aan je account en niet aan ons, en dat is de reden dat de server van jou is om te verhuizen; de deployment zet NO_LICENSE_KEY=1 zodat hij hier wordt aangeleverd en niet in de app wordt ingebakken. Als je de sleutel ooit opnieuw genereert, kun je hem later wijzigen zonder de wizard opnieuw te doorlopen: het is een veld in het tabblad Server Settings van het beheerpaneel.

5. Open de databaseopties en verbind de database

Dit is de stap die de meeste supporttickets oplevert, omdat de databasevelden verborgen zijn. Direct onder de sleutel staat een grijze knop, Databaseopties tonen/verbergen (geavanceerd). Klik erop. Pas dan verschijnen de velden Database Host, Port, Username, Password en Name. Als je de knop overslaat, draait het recipe met de standaardwaarden van txAdmin en mislukt de databaseverbinding.

De velden zijn vooraf ingevuld, met localhost als host en 3306 als poort. Die standaardwaarden kloppen niet op deze server. Vervang wat er in elk veld staat door deze waarden:

Host is de sync-operator en niet de databasecontainer, het wachtwoord is het wachtwoord dat je bij het deployen hebt gekozen, en de database zelf wordt leeg voor je aangemaakt voordat de server start.

Het wachtwoord staat in het beheerpaneel onder Deploy-instellingen, als MYSQL_ROOT_PASSWORD, met een onthul-knop en een kopieerknop. Het paneel drukt ook deze vier vaste waarden af op een kaartje ernaast, zodat je ze rechtstreeks in txAdmin kunt kopiëren zonder hier terug te komen.

Twee gokken zijn het noemen waard omdat beide fout zijn en beide juist lijken. Host is niet localhost: txAdmin en de database zijn aparte containers. Host is ook niet mariadb, ook al is er een component met die naam. Alles gaat via de operator, en die repliceert elke schrijfactie naar de andere instanties; rechtstreeks naar één MariaDB schrijven zou je stad laten desyncen en die verloren laten gaan bij een failover.

Voer dan het recipe uit. txAdmin downloadt de FiveM-artifact, importeert het schema, schrijft server.cfg en start de server, en je dashboard wordt binnen een paar minuten groen. Als je in plaats van een recipe een bestaande server hebt gekozen, zijn er geen databasevelden in te vullen: stel de verbinding in je server.cfg in, zoals hieronder in de vragen wordt getoond.

Als txAdmin meldt dat het niet kan verbinden

Controleer eerst de host en de poort, want localhost en mariadb zijn de gebruikelijke gokken en geen van beide werkt. Als die kloppen, is het een wachtwoordfout. De database wordt ingericht met MYSQL_ROOT_PASSWORD en de operator authenticeert met DB_INIT_PASS, en die twee moeten identiek zijn, anders kan de database hoe dan ook niet initialiseren. Het paneel houdt ze daarvoor aan elkaar gekoppeld: het bewerken van de ene herschrijft de andere, en het veld is als gekoppeld gemarkeerd, zodat het gedrag er niet uitziet als een formulier dat je invoer weigert. Wat je in txAdmin typt moet precies die waarde zijn.

Later weer inloggen

Na de wizard is txAdmin het dagelijkse paneel: live console, resources, bans, de CFG-editor en geplande herstarts. Dezelfde knop Open txAdmin brengt je er naartoe, en je logt in met het hoofdbeheerdersaccount uit stap 2. Het dashboard houdt de laag eronder bij: herstarts en redeploys, de bestandsbrowser, hardware, de databasegezondheid over nodes heen en backups.

Veelgestelde vragen