# Installation Guide

{% stepper %}
{% step %}

### 1. Download Resource

{% hint style="success" %}

#### Download the Resource from FiveM’s Portal

1. [👉 Download cd\_bridge →](https://portal.cfx.re/assets/granted-assets?search=cd_bridge)
2. Unzip the downloaded file
3. In your server’s `resources` directory, **create a folder named `[codesign]` if it does not already exist**
4. Place **`cd_bridge`** (and all other Codesign resources) inside the **`[codesign]`** folder
   {% endhint %}

<div align="left" data-with-frame="true"><figure><img src="https://789235289-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MSKsM-AnxI2icNixJI8%2Fuploads%2Fk0U7h0HTaURRy8TFztry%2Fimage.png?alt=media&#x26;token=fbadabff-7e9b-4b7a-9d60-7ed9b3aa1e17" alt=""><figcaption><p>Example resources folder with a <code>[codesign]</code> directory</p></figcaption></figure></div>
{% endstep %}

{% step %}

### 2. Resource Start Order

{% hint style="success" %}

#### Configure `server.cfg` Correctly

After placing the resource inside the **`[codesign]`** folder, ensure it starts last.

Add this to the bottom of your `server.cfg`:

```
ensure [codesign]
```

**Why:**\
`cd_bridge` auto-detects and integrates with frameworks (ESX / QBCore / QBox) and other resources such as inventory, phone, fuel, vehicle keys, and notifications.

These resources must start **before** `[codesign]` for detection to work correctly.
{% endhint %}

{% hint style="warning" %}

#### Important

⚠️ Place `ensure [codesign]` at the very bottom of your `server.cfg`.
{% endhint %}

<div align="left" data-with-frame="true"><figure><img src="https://789235289-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MSKsM-AnxI2icNixJI8%2Fuploads%2FolpA60Xg8QJYSvl5p14j%2Fimage.png?alt=media&#x26;token=7513c0f4-cd43-4b6f-a313-3855a7117078" alt=""><figcaption><p>Example server.cfg start order with <code>[codesign]</code> loaded last</p></figcaption></figure></div>
{% endstep %}

{% step %}

### 3. Configure Resource

{% hint style="success" %}

#### Bridge Configuration

You should review all configurable options in `cd_bridge/shared/config.lua` to understand what is available.

The bridge uses **automatic detection**, so **no configuration is required in most cases**. Supported frameworks and integrations are detected and handled automatically.

Each configuration option includes **commented lists of supported resources**. These comments show which integrations are available and can be **manually selected if needed**.

Only change these values if auto-detection does not suit your setup or if you want to **force a specific integration**.
{% endhint %}
{% endstep %}
{% endstepper %}