Artifacts are the FiveM server program itself (FXServer). Old artifacts stop being supported, and eventually players can't join the server from the server list. We'll show you when and how to update the server and how to roll back if the new version doesn't work.
What you'll need
- A FiveM server at StormHost (or your own FiveM server on a VPS)
- A free backup slot (game server backups)
- About 10 minutes
What artifacts are#
- An artifact is a package of FXServer files with a build number (the higher, the newer). Your data (
server.cfg,resources, the database) isn't in it, and an update doesn't change it. - txAdmin is part of the artifact. Updating the artifact also updates txAdmin.
- FiveM releases artifacts in two channels:
| Channel | What it means | Who it's for |
|---|---|---|
| Recommended | A tested build that FiveM recommends for everyday use. | Most servers. |
| Latest | The newest build with the latest features and fixes, less tested. | When a script or framework requires a new feature. |
- Classic FiveM (for GTA V Legacy) and FiveM for GTAV Enhanced each have their own artifacts. Don't mix them.
When to update#
- Regularly, at least once a month. A build from the Recommended channel is supported for 6 more weeks after the next one is released; a build from the Latest channel only for 2 weeks.
- Artifacts older than 3 months can't be joined from the server list. When connecting, players see a gray end-of-support (EOS) warning, and for even older ones a red end-of-life (EOL) warning that blocks connecting.
- When a script reports
Native … is not supported,Error parsing scriptorFailed to load script. The script needs a newer server. - After a new GTA V DLC is released and when you get the
Client/Server game build revision mismatcherror.
How to check the current version#
- The CFX Resolver tool: enter the server address from the Network tab. The Artifact row shows the server build, and Version support shows its status.
- In txAdmin: System › Diagnostics.
- The current Recommended and Latest numbers are on the Server Download (opens in a new window) page.
Updating at StormHost#
You update the artifacts by reinstalling the server: the install script downloads the selected FXServer version.
A reinstall may overwrite files
The customer area warns you before reinstalling: “Files may be overwritten — make a backup first.” Without a backup, you risk losing your changes. Back up the database separately (guide).
In the customer area, open My services, click your server and go to the Backups tab.
Create a backup (for example named
before-artifact-update) and wait for it to finish.Go to the Settings tab.
In the Variables section, find the FiveM version variable and set it:
Value What gets installed recommendedThe current build from the Recommended channel. Recommended. latestThe current build from the Latest channel. You can't set a specific older build here yet; the installation would use Recommended instead. A version picker in the customer area is coming soon.
Click Save.
In the Reinstall server section, click Reinstall and confirm with the Slide to reinstall slider.
You'll see
The reinstall is running. Follow it in the Console tab.Go to the Console tab and wait for the installation to finish. Then start the server with the Start button.
If you don't see the FiveM version variable, contact us (contacts) and we'll do the update for you.
On your own VPS (Linux)#
Stop the server (with the stop button in txAdmin, or end the process).
Back up the artifacts folder, for example
~/FXServer/server, and the server data folder.On the Server Download (opens in a new window) page, choose the platform, Linux and Recommended, and copy the link to the
fx.tar.xzfile.Go to the artifacts folder, then download and extract the files:
bash cd ~/FXServer/server wget <FX_TAR_XZ_LINK> tar xf fx.tar.xzcd ~/FXServer/server– switches to the artifacts folder (not the folder withserver.cfg).wget <FX_TAR_XZ_LINK>– downloads the archive. Replace<FX_TAR_XZ_LINK>with the link you copied.tar xf fx.tar.xz– extracts the archive and overwrites the old FXServer files (x= extract,f= from a file). Requires thexz-utilspackage.
Delete the archive (
rm fx.tar.xz) and start the server the same way as before: with txAdmin, usingbash ~/FXServer/server/run.sh(without+exec); without txAdmin, from the folder withserver.cfgusingbash ~/FXServer/server/run.sh +exec server.cfg.
Game build and DLC#
The artifact (server version) and the game build (game version with DLCs, sv_enforceGameBuild in server.cfg) are two different numbers. You can only enforce a new GTA V DLC with an artifact that supports it. The order: first update the artifacts, then raise sv_enforceGameBuild (server.cfg).
Verification#
- CFX Resolver shows the new build in the Artifact row.
- The server starts, txAdmin opens and the resources start without new errors.
- Players connect without an EOS or EOL warning.
Troubleshooting#
The server or scripts crash after the update#
If you switched to latest, set the version variable back to recommended and reinstall the server. To go back to an older build, restore the backup from step 2 (guide).
My changes are gone after the reinstall#
The reinstall overwrote the files. Restore the backup without the Delete all current files before restoring option, or download the files you need from the backup to your computer and upload them back.
Players report Server artifact version is outdated#
The server is running on an unsupported build. Update to recommended as described above.
Native … is not supported, Error parsing script, Failed to load script#
The script needs a newer server. Update to recommended, and if that's not enough, to latest.
Summary
- The artifact is the FXServer program, including txAdmin. Updating doesn't change your data.
- Update at least once a month: artifacts older than 3 months can't be joined from the server list.
- At StormHost: backup, version variable (
recommended), Reinstall, watch the Console. - If the new version doesn't work, go back to
recommendedor restore the backup.