# Getting Started

## Configure a default datasource in your CFML engine

You can do this any way you'd like: through the web admin, in `Application.cfc`, or using [cfconfig](https://cfconfig.ortusbooks.com).

Make sure to set `this.datasource` in your `Application.cfc` so Quick knows which datasource to use.

## Download Quick

The easiest way to download quick is to use forgebox with commandbox. Just run the following from the root of your application:

`box install quick`

## Add a mapping for `quick` in your `Application.cfc`

For a default installation in a ColdBox template, the following line will do the trick.

`this.mappings[ "/quick" ] = COLDBOX_APP_ROOT_PATH & "/modules/quick";`

## Configure your `defaultGrammar` in `config/ColdBox.cfc`

Quick will auto discover your grammar by default on startup. To avoid this check, set a `BaseGrammar`.

`BaseGrammar` is a module setting for Quick. Set it in your `config/ColdBox.cfc` like so:

```
moduleSettings = {
    quick = {
        defaultGrammar = "MySQLGrammar"
    }
};
```

Valid options are any of the [qb supported grammars](https://qb.ortusbooks.com). At the time of writing valid grammar options are: MySQLGrammar, PostgresGrammar, MSSQLGrammar and OracleGrammar. Please check the qb docs for additional options.

If you want to use a different datasource and/or grammar for individual entitities you can do so by [adding some metadata](https://quick.ortusbooks.com/2.3.0/defining-an-entity#multiple-datasource-support) attributes to your entities.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://quick.ortusbooks.com/2.3.0/getting-started.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.