{"record":{"id":"1a8fc12390296607","repo":"cube-js/cube","slug":"worker-thread-transpilation-is-enabled-by-default","errorCode":null,"errorMessage":"Worker thread transpilation is enabled by default and cannot be disabled with CUBEJS_TRANSPILATION_WORKER_THREADS.","messagePattern":"Worker thread transpilation is enabled by default and cannot be disabled with CUBEJS_TRANSPILATION_WORKER_THREADS\\.","errorType":"console","errorClass":null,"httpStatus":null,"severity":"info","filePath":"packages/cubejs-backend-shared/src/env.ts","lineNumber":334,"sourceCode":"    const explicitlySet = process.env.CUBEJS_TESSERACT_SQL_PLANNER !== undefined;\n    const enabled = get('CUBEJS_TESSERACT_SQL_PLANNER').default('true').asBool();\n\n    if (explicitlySet && !enabled) {\n      displayCLIWarningOnce(\n        'CUBEJS_TESSERACT_SQL_PLANNER',\n        'Tesseract planner is a default one, but you are trying to use a legacy planner which will be removed in the near future.'\n      );\n    }\n\n    return enabled;\n  },\n  transpilationWorkerThreads: () => {\n    const enabled = get('CUBEJS_TRANSPILATION_WORKER_THREADS')\n      .default('true')\n      .asBoolStrict();\n\n    if (!enabled) {\n      console.warn(\n        'Worker thread transpilation is enabled by default and cannot be disabled with CUBEJS_TRANSPILATION_WORKER_THREADS.'\n      );\n    }\n\n    return true;\n  },\n  allowNonStrictDateRangeMatching: () => get('CUBEJS_PRE_AGGREGATIONS_ALLOW_NON_STRICT_DATE_RANGE_MATCH')\n    .default('true')\n    .asBoolStrict(),\n  transpilationWorkerThreadsCount: () => get('CUBEJS_TRANSPILATION_WORKER_THREADS_COUNT')\n    .default('0')\n    .asInt(),\n  // This one takes precedence over CUBEJS_TRANSPILATION_WORKER_THREADS\n  transpilationNative: () => get('CUBEJS_TRANSPILATION_NATIVE')\n    .default('false')\n    .asBoolStrict(),\n  nestedFoldersDelimiter: () => get('CUBEJS_NESTED_FOLDERS_DELIMITER')\n    .default('')","sourceCodeStart":316,"sourceCodeEnd":352,"githubUrl":"https://github.com/cube-js/cube/blob/7d981676b36392fec34088b9afab6bdcad40207c/packages/cubejs-backend-shared/src/env.ts#L316-L352","documentation":"Transpilation in worker threads is a mandatory default in current Cube builds. Setting CUBEJS_TRANSPILATION_WORKER_THREADS=false no longer disables it; the env parser logs this warning and forces the value to true.","triggerScenarios":"The environment contains CUBEJS_TRANSPILATION_WORKER_THREADS set to 'false' (or any non-true strict-bool value); env.transpilationWorkerThreads() evaluates it and warns before returning true.","commonSituations":"Upgrading Cube from an older version where the flag still disabled worker threads; leftover flag in docker-compose/env files copied from older templates; attempts to avoid worker-thread overhead in constrained environments.","solutions":["Remove the CUBEJS_TRANSPILATION_WORKER_THREADS env var since it no longer has an effect","Accept worker-thread transpilation and tune related compile settings instead","If worker threads cause a real problem, report it to Cube maintainers rather than relying on this flag"],"exampleFix":"// before\nCUBEJS_TRANSPILATION_WORKER_THREADS=false\n// after\n# remove the variable entirely (worker threads are always on)","handlingStrategy":"validation","validationCode":"if ('CUBEJS_TRANSPILATION_WORKER_THREADS' in process.env && process.env.CUBEJS_TRANSPILATION_WORKER_THREADS === 'false') {\n  console.warn('CUBEJS_TRANSPILATION_WORKER_THREADS=false is ignored; worker threads are always enabled');\n}","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Remove obsolete flags when upgrading Cube versions","Keep env templates synced with the current version's supported variables","Grep CI env files for removed flags"],"tags":["env","deprecation","worker-threads","compilation"],"backgroundTag":"deprecated-env-var-ignored","analyzedSha":"7d981676b36392fec34088b9afab6bdcad40207c","analyzedAt":"2026-09-02T03:45:10.400Z","contentChangedAt":null,"schemaVersion":2},"datasetVersion":"2026-09-08T15:18:49.778Z"}