cube-js/cube · error

Cube Store was specified as queue/cache driver. Please set C

Error message

Cube Store was specified as queue/cache driver. Please set CUBEJS_CUBESTORE_HOST and CUBEJS_CUBESTORE_PORT variables. Please see https://cube.dev/docs/deployment/production-checklist#set-up-cube-store to learn more.

What it means

Fires when the Cube Store queue/cache driver needs its own CubeStoreDriver but no external driver is available to reuse and no connection can be established, so the constructor demands CUBEJS_CUBESTORE_HOST and CUBEJS_CUBESTORE_PORT before proceeding.

Source

Thrown at packages/cubejs-query-orchestrator/src/orchestrator/QueryOrchestrator.ts:100

        `Only 'cubestore' or 'memory' are supported for cacheAndQueueDriver option, passed: ${cacheAndQueueDriver}`
      );
    }

    const { externalDriverFactory, continueWaitTimeout, skipExternalCacheAndQueue } = options;

    this.cacheAndQueueDriver = cacheAndQueueDriver;

    const cubeStoreDriverFactory = cacheAndQueueDriver === 'cubestore' ? async () => {
      if (externalDriverFactory) {
        const externalDriver = await externalDriverFactory();
        if (externalDriver instanceof CubeStoreDriver) {
          return externalDriver;
        }

        throw new Error('It`s not possible to use Cube Store as queue/cache driver without using it as external');
      }

      throw new Error('Cube Store was specified as queue/cache driver. Please set CUBEJS_CUBESTORE_HOST and CUBEJS_CUBESTORE_PORT variables. Please see https://cube.dev/docs/deployment/production-checklist#set-up-cube-store to learn more.');
    } : undefined;

    this.queryCache = new QueryCache(
      this.redisPrefix,
      driverFactory,
      this.logger,
      {
        externalDriverFactory,
        cacheAndQueueDriver,
        cubeStoreDriverFactory,
        continueWaitTimeout,
        skipExternalCacheAndQueue,
        ...options.queryCacheOptions,
      }
    );
    this.preAggregations = new PreAggregations(
      this.redisPrefix,
      this.driverFactory,

View on GitHub (pinned to 7d981676b3)

Solutions

1. Set CUBEJS_CUBESTORE_HOST and CUBEJS_CUBESTORE_PORT environment variables pointing at the running Cube Store instance
2. Start Cube Store (docker or the native binary) so the configured host/port accept connections
3. If Cube Store is not desired, switch the cache/queue driver to 'memory'

When it happens

Trigger: Thrown at packages/cubejs-query-orchestrator/src/orchestrator/QueryOrchestrator.ts:100 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of cube-js/cube@7d981676b3 (2026-09-02). Data as JSON: /api/errors/f6db1ae66378abd9. Report an issue: GitHub.