Install txAdmin on Pterodactyl
Configure a FiveM Pterodactyl egg, txAdmin startup, panel ports and data persistence without mixing up game and admin endpoints.
txAdmin runs inside FXServer, not as a separate Pterodactyl application. Start with an egg that explicitly supports txAdmin; the community FiveM egg documents TXADMIN_ENABLED and the TXHOST_* settings. Egg variables and behavior vary between releases.
Before you start
- Have a working Pterodactyl server, compatible FXServer artifacts, and a Cfx Portal license key.
- Allocate a game port (commonly
30120, TCP and UDP) and a separate panel TCP port (normally40120). The egg may require additional allocations; use its documented defaults. - Confirm the container has a persistent writable
txDatadirectory. Back up existingtxData,server.cfg, resources, and any framework database before reinstallation.
Configure the egg
- In the Pterodactyl Startup tab, inspect the currently installed FiveM egg and its txAdmin switch. Where present, turn on
TXADMIN_ENABLED=1. - Verify the panel-port allocation and set
TXHOST_TXA_PORTto its assigned TCP port. Pterodactyl will not automatically expose an arbitrary container port merely because an environment variable names it. - Check whether the egg provides
TXHOST_DATA_PATH; ensure it points to a writable persistent directory such as/home/container/txData. - Use
TXHOST_GAME_NAME=fivemfor FiveM orredmfor RedM if the egg implements that option. Follow the egg's reinstallation requirements when switching games. - Inspect the final startup command. The txAdmin start must not pass
+exec server.cfg; txAdmin handles deployment and launches the configured server itself.
Pterodactyl egg custom variables appear in the container environment, but they are not necessarily secrets. Do not save tokens in public egg definitions.
First boot
- Start the server from Pterodactyl. Read the Console for the txAdmin URL and temporary PIN.
- Open the assigned panel address and link the appropriate Cfx.re account.
- Deploy into an empty target folder and verify the
server.cfgandresourcesdirectories. - Start the game server in txAdmin; running the container alone does not necessarily start the game.
- Test both the panel login and a real client connection.
Diagnose the common failures
| Symptom | Check |
|---|---|
| Panel URL times out | Is the allocated TCP port mapped to the container and allowed by the host firewall? |
E5800 / address already in use | Check for an existing panel listener and conflicting port allocation. See E5800. |
| Server starts without txAdmin | Check TXADMIN_ENABLED, startup command and artifact compatibility. |
| txData disappears after reinstallation | Check volume path and backup; do not rerun a destructive reinstall until data is saved. |
| Deployer fails to download | Inspect the failing recipe task and Recipe 403. |
Security: A port allocation is not access control. Prefer limiting admin access at the network level; do not publish the panel as an unauthenticated public reverse proxy.
Sources: Pterodactyl game egg, Pterodactyl egg variables, txAdmin environment reference.