By the end of this guide your RedM server runs the Cfx.re server version you picked: the recommended one, the latest one or a fixed build number. You will know which files the update replaces and which stay. You will also know how to go back if a resource does not work with the new build.

Prerequisites

  • A RedM server in your customer panel. Only the owner of the server can reinstall it.
  • A moment when nobody is playing. The server stops during the update.

How the server version works

Cfx.re publishes the RedM server as an artifact with a build number. The Cfx.re version list names, among others, a recommended build (recommended) and the newest build (latest). The files themselves are on the Cfx.re artifact page.

According to the txAdmin project, txAdmin is part of the server. Updating the artifact therefore also updates txAdmin. The version list also shows which txAdmin version ships with which build.

Your server only fetches the artifact during an installation. A normal restart does not load a new version.

Check the current version

Open Files & worlds → Files and the file .gsh-cfx-installed in the top folder. The artifact= line holds the address of the installed artifact. The number before the hyphen in the path is the build number. Write it down before you update, because the next installation overwrites the file.

Pick a version

  1. Open Game settings → Server Variables.
  2. Enter one of these values in the "Cfx.re artifact version" field:
    • recommended for the build Cfx.re recommends. This is the default.
    • latest for the newest build.
    • A build number, for example the one you wrote down, to stay on a specific build.
  3. Save the change.

If the build number is not on the artifact page, the server installs the recommended build. During the installation the console then shows Requested version … unavailable; using recommended.

Run the update

  1. Create a backup under Backups & recovery. The panel makes one by itself before a reinstall, but with your own you know exactly which state it holds.
  2. Click Reinstall in the server's control bar.
  3. Confirm the reinstall. If the panel asks for your server's name, type it in.
  4. Wait until the installation finishes. It usually takes a few minutes.
  5. Start the server and check in the console or in txAdmin's "Live Console" that it boots without errors.

What the update keeps

The installation fully replaces the alpine folder with the server files. These stay:

  • The txData folder with your txAdmin setup, your admins and the server folder from the setup.
  • Your own resources in the resources folder. From the Cfx.re standard pack, only files that are still missing are added.
  • An existing server.cfg in the top folder. The installation only comments out resources that FXServer no longer ships, such as sessionmanager, and only if you did not install them yourself.

Going back to the old version

If a resource does not run on the new build, enter the build number you wrote down under "Cfx.re artifact version" again and reinstall. If that does not help, restore the backup under Backups & recovery. In the version list, Cfx.re gives older builds an end date under support_policy, so do not stay on an old build for good.

Common problems

Problem Cause and fix
The version is unchanged after a restart A restart does not load a new version. Run Reinstall.
The recommended build was installed instead of yours That build number is not on the artifact page. Check the number and enter digits only.
The installation stops with Cfx.re returned no valid Linux artifact URL Cfx.re did not return a valid address. Try again later or choose recommended.
The installation reports Incomplete Cfx.re artifact The download was incomplete. Start the installation again.
Reinstall is not available Only the server owner may reinstall. Log in with that account.
A resource does not start after the update Read the error line in the console. Go back to the build number you noted if needed.

Next steps

How to set up admins, restart times and the allowlist in txAdmin is covered in Manage admins and restarts in txAdmin. Slots and locations are on the RedM order page.