how to install Qbox on a FiveM server using TXAdmin

Qbox is one of the most popular frameworks for building FiveM roleplay servers. It is fast, clean, and developer-friendly, making it a great choice for anyone who wants to build a serious RP community. In this guide, we’ll walk through how to install Qbox on a FiveM server using TXAdmin step by step — from downloading FXServer to making your server public and ready for players.

Whether you are completely new or migrating from QBCore, this blog will cover everything you need: installation, database setup, port forwarding, and even how to troubleshoot common issues. By the end, you will have a fully working Qbox server running on your machine.

What Is Qbox?

Qbox is a server framework for FiveM. Think of it as the brain of your server — it controls players, inventories, jobs, and other RP features. Qbox is a modern fork of QBCore, meaning it takes QBCore’s features and improves them.

Qbox vs QBCore

Qbox is faster: Its codebase is optimized for better server performance.
Developer-friendly: Code is cleaner and easier to modify.
Multicharacter built-in: Players can create and switch between characters without extra scripts.
Actively maintained: The developers push frequent updates.

This means Qbox is perfect for new servers and communities looking for a stable, modern framework.

Before Installation

Before installing Qbox, make sure you have these tools ready:

FXServer (FiveM Artifacts): Download from the official artifacts page.
TXAdmin: Comes with FXServer.
MariaDB: Used to store all player data.
HeidiSQL (Optional): Easy tool to browse your database.
A Windows PC with admin access.

Tip: Place your server folder on an SSD for faster loading times.

Step-by-Step: Install Qbox Using TXAdmin

1. Download and Install FXServer

Visit the FiveM artifacts page.
Download the latest recommended build.
Extract it to a folder (e.g. C:\QboxServer\artifacts).

2. Launch FXServer

Open FXServer.exe.
Windows may warn you — click More Info > Run Anyway.
Your browser will open TXAdmin automatically.

3. Link Your Account

Log in with your CFX.re account.
Click Link Account and follow the prompts.

4. Create a New Server

In TXAdmin, click Setup > Create New Server.
Select Popular Recipes.
Choose Qbox Framework.
Pick your installation folder (e.g. C:\QboxServer\txData).
Click Save & Run Recipe.

TXAdmin will now download and install Qbox automatically.

Configure Your Database (MariaDB)

Qbox stores all data (characters, inventories, money) in a database.

Step 1: Install MariaDB

Download MariaDB from mariadb.org. During installation:

Keep the default service name.
Choose UTF8 as the character set.
Leave the root password unchecked for local use.

Step 2: Create a Database

Open HeidiSQL.
Click New Session and connect to MariaDB.
Right-click the connection and choose Create New > Database.
Name it qbox_server or anything you like.

Step 3: Link Database in TXAdmin

Go back to TXAdmin.
Click Show/Hide Database Options.
Enter:
- Host: 127.0.0.1
- Database: qbox_server
- User: root (or your custom user)
- Password: (leave blank if none)
Save changes.

Start and Test Your Qbox Server

Go to Live Console in TXAdmin.
Click Start Server.
Wait for the console to say the server has started successfully.
Open FiveM.
Go to Direct Connect and type localhost.
Join your server and create a character.

If you can connect, congratulations — your Qbox server is running locally!

Adding Scripts and Resources

Qbox supports custom scripts (jobs, gangs, housing). To add them:

Download a Qbox script.
Place it in the resources folder inside your server directory.
Edit server.cfg and add: ‘ensure scriptname‘
Restart your server.

This is how you expand your server with custom content.

Make Your Server Public (Port Forwarding)

If you want friends or players to join, make your server public.

Step 1: Port Forwarding

Open Command Prompt and type ipconfig.
Copy your IPv4 address.
Open a browser and enter your router’s default gateway (e.g. 192.168.1.1).
Log in to your router.
Find Port Forwarding or Virtual Servers.
Add a rule for port 30120 (TCP + UDP) pointing to your PC’s IPv4.

Step 2: Firewall Rules

Open Windows Defender Firewall > Advanced Settings.
Create inbound & outbound rules for FXServer.exe.
Add a rule for port 30120 (TCP + UDP).

Restart your server and wait 30 minutes to 2 hours for it to show on the FiveM list.

Updating Qbox

Keeping Qbox updated is simple:

Download the latest Qbox release from the Qbox GitHub.
Replace old files in your txData folder with the new ones.
Restart TXAdmin.

Troubleshooting Common Issues

Server not showing up: Check port forwarding and firewall rules again.
Database connection failed: Double-check database name, user, and password.
Scripts not working: Ensure they are Qbox-compatible and placed in the correct folder.
Players can’t connect: Use your public IP address, not localhost.

Conclusion

You now know how to install Qbox, connect it to MariaDB, add resources, port forward, and make your server public. By following this guide, you have everything needed to create and grow your own RP server.

Next steps: add jobs, housing, vehicles, and optimize your server for performance. Check the Qbox docs for advanced tips.

Building a server is a process — but with Qbox and TXAdmin, you are set up for success.

FAQs

What is Qbox?

Qbox is a modern FiveM framework that powers RP servers with jobs, inventory, and character systems.