# Installation

::::steps
### Dependencies

Make sure these are installed and started **before** Koja Trucker:

```cfg
ensure oxmysql
ensure koja-lib
```


### Drop in the resource

1. Extract the resource into your server's `resources` directory.
2. Keep the folder name **`koja-trucker`** (exports and events are namespaced to it).
3. Add it to your `server.cfg`:

```cfg
ensure koja-trucker
```


### Database

The required tables are created **automatically** on first start (controlled by `general.autoCreateTable` in the config). You don't need to import any SQL.

The resource owns these tables — all prefixed `koja-trucker*`:

| Table                                | Purpose                                            |
| ------------------------------------ | -------------------------------------------------- |
| `koja-trucker`                       | Per-player level, XP, skill points, skills, totals |
| `koja-trucker-accounts`              | Display name & account type                        |
| `koja-trucker-companies`             | Companies                                          |
| `koja-trucker-company-members`       | Membership & roles                                 |
| `koja-trucker-company-invitations`   | Outgoing invites                                   |
| `koja-trucker-company-requests`      | Join requests                                      |
| `koja-trucker-company-activity`      | Live activity feed                                 |
| `koja-trucker-shipment-history`      | Delivery history                                   |
| `koja-trucker-promocodes`            | Promo codes                                        |
| `koja-trucker-promocode-redemptions` | Who redeemed what                                  |
| `koja-trucker-quests`                | Per-player daily/weekly quest state                |

:::hint{type="warning"}
If you manage migrations yourself, set `autoCreateTable` to `false` in the config (or toggle **Auto-create database table** off in the admin panel).
:::


### Framework

Koja Trucker auto-detects **ESX**, **QBCore** or **ox** through `koja-lib`. No manual bridge configuration is required in the common case.


### First launch

1. Start the server and join.
2. Open the tablet (default command **`/trucker`** — see [Configuration](/jobs/trucker/configuration) to rename it).
3. Grant yourself admin (see [Admin panel](/jobs/trucker/configuration/admin/panel)) to start creating depots and orders.
::::

## Related pages

- [Commands](/jobs/trucker/commands) — Every admin command lives under one root: /truckeradmin.
- [Features](/jobs/trucker/features) — Koja Trucker includes a full set of progression, social, and admin-driven systems.
- [Configuration](/jobs/trucker/configuration) — Almost everything is editable live from the in-game admin panel (no restart), and persisted to data/config.json. You can also edit that file directly.
- [Trucker](/jobs/trucker) — back to the section overview