Prepare a host for QBCore
This section prepares Windows or Linux infrastructure: FiveM artifacts, txAdmin, database access, networking, backups, and deployment boundaries. When the host is ready, the quickstart performs the recipe deployment.
Create a new txAdmin profile and an empty database. Back up and test restore procedures before moving existing data or custom resources.
Deployment boundaries
- Host: install a current FiveM artifact and open txAdmin.
- Database: create an empty development database and least-privilege application account.
- Recipe: verify the owner is
qbcore-framework/txAdminRecipeand deploy itsmainbranch. - First boot: require a clean console, character persistence, and basic resource smoke tests.
- Customization: create a Git baseline before editing files or adding third-party resources.
Manual source installation
Manual installation is an advanced maintenance workflow, not the quick path. If you choose it, inspect the current recipe first: it defines the required repositories, refs, dependency order, oxmysql package, and SQL import. Do not substitute an old blog post or an arbitrary server pack for that dependency graph.
Required evidence before production
- Exact commit SHAs for every customized repository
- Restorable file and database backups
- A staging smoke-test record
- A documented resource start order
- A rollback owner and maintenance window
Continue with the quickstart for deployment or getting started for first-boot verification.