> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lumixsolutions.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Startup Issues

> Diagnose and fix FiveM servers that won't boot.

When a FiveM server won't start, the [Console](/lumi-panel/general/console) is your best friend - the error is almost always on the last 20-30 lines. Below are the issues we see most often.

## Invalid or missing license key

```text theme={null}
Server requires a valid sv_licenseKey to start.
```

Generate a key at [portal.cfx.re](https://portal.cfx.re), tied to **this server's IP** (the one shown in [Network](/lumi-panel/management/network)). Then set it in the [Startup](/lumi-panel/configuration/startup) tab under `FIVEM_LICENSE`, or directly in `server.cfg`:

```cfg theme={null}
sv_licenseKey "cfxk_xxxxxxxxxxxxxxxxxxxx_xxxx"
```

Restart the server after saving.

## License key bound to a different IP

```text theme={null}
This server's license key does not match the configured server.
```

Keymaster keys are locked to one IP. If your server was migrated or you're reusing a key from another host, regenerate it against the current Lumi-Panel IP.

## Artifact / build mismatch

```text theme={null}
couldn't load resource ...: script runtime not found
```

Resources built for newer Cfx artifacts won't run on older ones (and vice versa). Update the artifact in the [Startup](/lumi-panel/configuration/startup) tab - pick the latest **recommended** build, not bleeding-edge unless you know you need it. Restart.

## Resource failed to start

```text theme={null}
Couldn't start resource <name>.
```

Look a few lines above the error - the actual cause (missing dependency, syntax error, missing file) is logged there. Common fixes:

* Add the missing `ensure` line for a dependency in `server.cfg`.
* Re-upload the resource over [SFTP](/lumi-panel/general/settings) - partial uploads cause Lua syntax errors.
* Check resource manifest (`fxmanifest.lua`) for typos.

## Database connection refused on boot

```text theme={null}
[oxmysql] Failed to connect: ECONNREFUSED
```

The DB isn't reachable from your server. Walk through [Database Setup](/games/fivem/database-setup) - the most common cause is the connection string pointing at `localhost` instead of the Lumi-Panel database endpoint.

## Out of memory on boot

```text theme={null}
fxserver killed (out of memory)
```

You're hitting your plan's RAM limit while loading resources. Either trim resources or upgrade the plan - [open a ticket](https://billing.lumixsolutions.org/submitticket.php) and we'll size you up.

## Still stuck?

Copy the last \~50 lines of the console, sign in to the [Billing Portal](https://billing.lumixsolutions.org), and [open a ticket](https://billing.lumixsolutions.org/submitticket.php). A real engineer will respond - not a script reader.