> For the complete documentation index, see [llms.txt](https://cbq.ortusbooks.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cbq.ortusbooks.com/6.0.0/getting-started/installation.md).

# Installation

## Requirements

cbq requires the following:

* Adobe ColdFusion (ACF) 2018+ **OR** Lucee 5+
* ColdBox 6+

The different [Queue Providers](/6.0.0/configuration/providers.md) each have their own requirements that are listed on their individual pages.

## Install via ForgeBox with CommandBox

cbq is installed via [ForgeBox](https://forgebox.io) with [CommandBox](https://www.ortussolutions.com/products/commandbox). You can install the latest version using the command:

```shell
install cbq
```

To stay on the v6 release line, install a version constraint:

```shell
box install cbq@^6.0.0
```

Installing cbq does not apply database migrations. Before starting workers or dispatching batches, apply the migrations for the tables you use. See the [Upgrade Guide](/6.0.0/upgrade-guide.md#v5-to-v6) and [DBProvider setup](/6.0.0/configuration/providers/dbprovider.md#jobs-table-structure).

## Load Java Libraries

When using batches, cbq utilizes additional Java libraries included in the `lib/` folder. These need to be added to your Application's `javaSettings` in `Application.cfc`.

```cfscript
// Java Integration
this.javaSettings = {
    loadPaths: [ expandPath( "./modules/cbq/lib" ) ],
    loadColdFusionClassPath: true,
    reloadOnChange: false
};
```

{% hint style="info" %}
Feel free to use mappings to point to the cbq path, if needed.
{% endhint %}

Append the cbq library path if your application already defines `javaSettings.loadPaths`, and restart the application after changing it. A `ClassNotFoundException` for `com.fasterxml.uuid.Generators` means the bundled UUID library is missing from the application's classpath; changing the Java version alone does not add it. Use a Java version supported by your CFML engine.

## Additional Provider Installation Steps

The [Queue Provider ](/6.0.0/configuration/providers.md)you use may have additional installation steps. Check out the individual provider pages for more details.