ND Core Installation

ND Core installs either from a txAdmin remote recipe or by hand. The recipe is recommended, and there are three variants to choose between.

Prerequisites

ND Core is stricter than most frameworks about the platform underneath it.

FXServer artifacts version 12000 or higher (not "Latest Recommended")
Game build set to 2802 or higher in server.cfg
OneSync Infinity enabled — legacy OneSync is not supported
MariaDB installed (not XAMPP)
Cfx.re account and server license key

⚠️

Do not use the “Latest Recommended” or “Latest Optional” buttons on the artifacts page — the ND documentation notes they are well behind. Pick a build of 12000 or higher directly from the list. See Server artifacts.

Method 1 — txAdmin remote recipe

Start FXServer

Run FXServer.exe and link your Cfx.re account in the txAdmin wizard.

Choose Remote URL Template

At the deployment type step, select Remote URL Template rather than Popular Recipes — ND Core is not in the built-in recipe list.

Pick a recipe variant

ND Main is the full experience including every free resource and the current character creation system. ND Lite is a minimal build. ND Legacy is the older layout.

Fill in the parameters

Expand “Show/Hide Database options (advanced)” if the database fields are not visible, then enter your credentials.

Start the server

Run the recipe, then start the server from the txAdmin dashboard.

Official setup guide →

Method 2 — manual installation

Install the dependencies

Download releases of oxmysql and ox_lib into your resources folder.

Install ND_Core

Download the latest ND_Core release and extract it alongside them.

Add the optional resources

Most ND add-ons expect ox_inventory and ox_target.

Create ndcore.cfg

setr core:serverName “My FiveM Server”
setr core:discordInvite “https://discord.gg/your-invite ”
setr core:discordAppId “your-app-id”

Set the start order in server.cfg

exec ndcore.cfg
start oxmysql
start ox_lib
start ND_Core
all other resources below

⚠️

exec ndcore.cfg must come before ND_Core starts. If the convars are not set when the resource initialises, the core reads defaults and your server name and Discord settings are ignored.

Validation

Console reaches "Started resource ND_Core" with no errors
No OneSync warnings in the console on startup
You can connect, create a character and spawn
The character and its money persist across a restart
Your server name from ndcore.cfg appears in game

The server-name check is the quickest way to confirm exec ndcore.cfg is in the right place.

Rollback

Stop FXServer
Drop and recreate the database, then restore your last dump
Restore the previous resources folder, server.cfg and ndcore.cfg
Confirm players can connect before trying again

See Backups.

Next steps

ND Core overview
Server functions →
ox_lib — a required dependency

Overview Framework Migration