# bunqueue v2.6.108

bunqueue.config.ts, Global configuration file, defineConfig() helper, --config / -c CLI flag, cloudAgent.createFromConfig() and more.

Canonical: https://bunqueue.dev/blog/bunqueue-v2-6-108/

---

<!-- Generated from changelog.md by docs/scripts/generate-release-posts.ts. Edit the changelog and regenerate. -->

bunqueue.config.ts, Global configuration file, defineConfig() helper, --config / -c CLI flag, cloudAgent.createFromConfig() and more.

![](https://github.com/egeominotti.png?size=64) [egeominotti](https://github.com/egeominotti)

#### To install bunqueue v2.6.108

```bash title="bun"
bun add bunqueue@2.6.108
```

```bash title="npm"
npm install bunqueue@2.6.108
```

#### To upgrade bunqueue

```bash
bun add bunqueue@latest
```

## `bunqueue.config.ts`, Global configuration file

Centralize all server configuration in a single typed file, similar to `vite.config.ts` or `drizzle.config.ts`. Auto-discovered from project root, supports `bunqueue.config.{ts,js,mjs}`. Priority: CLI flags > config file > env vars > defaults. Zero breaking changes, env vars continue to work as fallback.

## `defineConfig()` helper

Exported from both `bunqueue` and `bunqueue/client` for full TypeScript IntelliSense.

## `--config` / `-c` CLI flag

`bunqueue start --config ./custom.config.ts` to specify an explicit config file path.

## `CloudAgent.createFromConfig()`

Static factory method that accepts a pre-resolved `CloudConfig`, used by the config file flow.

## New docs page

`/guide/configuration/` with full reference, examples for development, production, and Docker/Kubernetes.

## Updated 17 docs pages

All documentation now references `bunqueue.config.ts` as the recommended configuration approach.

## Thanks to 1 contributor!

- [@egeominotti](https://github.com/egeominotti)

---

[← bunqueue v2.6.107](https://bunqueue.dev/blog/bunqueue-v2-6-107/) · [Release on GitHub](https://github.com/egeominotti/bunqueue/releases/tag/v2.6.108) · [Commits since v2.6.107](https://github.com/egeominotti/bunqueue/compare/v2.6.107...v2.6.108) · [Full changelog](https://bunqueue.dev/changelog/) · [All posts](https://bunqueue.dev/blog/)