{"record":{"id":"6c342d7bf177db99","repo":"cube-js/cube","slug":"you-are-using-process-env-platform-on-arm64-wit","errorCode":null,"errorMessage":"You are using ${process.env} platform on arm64 with MUSL as standard library which is not supported by Cube Store, please use libc (GNU)","messagePattern":"You are using (.+?) platform on arm64 with MUSL as standard library which is not supported by Cube Store, please use libc \\(GNU\\)","errorType":"exception","errorClass":"Error","httpStatus":null,"severity":"critical","filePath":"rust/cubestore/js-wrapper/src/utils.ts","lineNumber":27,"sourceCode":"      case 'linux':\n        return `x86_64-unknown-linux-${detectLibc()}`;\n      case 'darwin':\n        return 'x86_64-apple-darwin';\n      default:\n        throw new Error(\n          `You are using ${process.env} platform on x86 which is not supported by Cube Store`,\n        );\n    }\n  }\n\n  if (process.arch === 'arm64') {\n    switch (process.platform) {\n      case 'linux':\n        switch (detectLibc()) {\n          case 'gnu':\n            return 'aarch64-unknown-linux-gnu';\n          default:\n            throw new Error(\n              `You are using ${process.env} platform on arm64 with MUSL as standard library which is not supported by Cube Store, please use libc (GNU)`,\n            );\n        }\n      case 'darwin':\n        return 'aarch64-apple-darwin';\n      default:\n        throw new Error(\n          `You are using ${process.env} platform on arm64 which is not supported by Cube Store`,\n        );\n    }\n  }\n\n  throw new Error(\n    `You are using ${process.arch} architecture on ${process.platform} platform which is not supported by Cube Store`,\n  );\n}\n\nexport function isCubeStoreSupported(): boolean {","sourceCodeStart":9,"sourceCodeEnd":45,"githubUrl":"https://github.com/cube-js/cube/blob/7d981676b36392fec34088b9afab6bdcad40207c/rust/cubestore/js-wrapper/src/utils.ts#L9-L45","documentation":"Cube Store's JS wrapper (rust/cubestore/js-wrapper/src/utils.ts, getTarget) resolves the native binary target triple for the current platform. On arm64 Linux only GNU libc is supported; when detectLibc() reports MUSL (e.g. Alpine), it throws because no MUSL arm64 Cube Store binary is published. Note the message incorrectly interpolates ${process.env} instead of ${process.platform}, so it prints an object dump.","triggerScenarios":"process.arch === 'arm64', process.platform === 'linux', and detectLibc() !== 'gnu' when getTarget() is called (via currentTarget) to locate the Cube Store native binary.","commonSituations":"Running Cube (npm install / cubejs-server) inside an Alpine arm64 container, e.g. node:20-alpine on Apple Silicon or Graviton hosts; MUSL-based minimal images for edge deployments.","solutions":["Switch to a Debian/GNU-based image (node:20-bookworm or the official cubejs/cube image) instead of Alpine","Run Cube Store as a separate container from the official cubejs/cubestore image and connect remotely (CUBEJS_CUBE_STORE_REMOTE settings)","Build Cube Store from Rust source (cargo build --release in rust/cubestore) and point CUBEJS_CUBE_STORE_BINARY_PATH at the binary","Fall back to x64 GNU where both MUSL/GNU builds exist, if arm64 is not a hard requirement"],"exampleFix":"// before (Dockerfile)\nFROM node:20-alpine\n// after\nFROM node:20-bookworm","handlingStrategy":"validation","validationCode":"import { detectLibc } from '@cubejs-backend/shared';\nif (process.arch === 'arm64' && process.platform === 'linux' && detectLibc() !== 'gnu') {\n  throw new Error('Cube Store requires GNU libc on arm64 Linux; use a Debian-based image.');\n}","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Use Debian/Ubuntu-based base images (node:XX-bookworm) instead of Alpine on arm64","Call isCubeStoreSupported() from @cubejs-backend/cubestore at startup before enabling local Cube Store","Prefer official cubejs/cube and cubejs/cubestore Docker images"],"tags":["platform","arm64","musl","alpine","native-binary"],"backgroundTag":"unsupported-platform-libc","analyzedSha":"7d981676b36392fec34088b9afab6bdcad40207c","analyzedAt":"2026-09-02T03:45:10.400Z","contentChangedAt":null,"schemaVersion":2},"datasetVersion":"2026-09-08T15:18:49.778Z"}