[Bug] gremlin-console.sh fails on Mac M4 (Apple Silicon)

[vaijosh]

Bug Type (问题类型)

others (please edit later)

Before submit

• 我已经确认现有的 Issues 与 FAQ 中没有相同 / 重复问题 (I have confirmed and searched that there are no similar problems in the historical issue and documents)

Environment (环境信息)

• Server Version: 1.0.0 (Apache Release Version)
• Backend: RocksDB x nodes, HDD or SSD
• OS: xx CPUs, xx G RAM, Ubuntu 2x.x / CentOS 7.x
• Data Size: xx vertices, xx edges

Expected & Actual behavior (期望与实际表现)

The bundled Gremlin Console (bin/gremlin-console.sh) fails to start on Mac M4 (Apple Silicon) due to native library (Jansi) incompatibility

On Mac M4, running Gremlin Console results in errors like: java.lang.UnsatisfiedLinkError: Could not load library. Reasons: [no jansi in java.library.path ... (fat file, but missing compatible architecture (have 'x86_64,i386', need 'arm64'))]

Vertex/Edge example (问题点 / 边数据举例)

Schema [VertexLabel, EdgeLabel, IndexLabel] (元数据结构)

[dosubot]

@vaijosh — this is a known problem on Apple Silicon. The bundled Jansi library only ships x86_64 and i386 binaries, so it crashes with UnsatisfiedLinkError when run on arm64 [1].

A few things that may help:

1. Use Java 11 (not 17+) — Gremlin Console's Groovy 2.5.14 doesn't support Java 17 bytecode, so Java 11 is the maximum supported version [2].

2. Workaround: upgrade Jansi manually — You can try replacing the bundled jansi-*.jar in the console's lib/ directory with Jansi 2.4.1+, which includes native arm64 support for macOS.

3. For Docker-based workflows — PR refactor(docker): migrate single-node compose from host to bridge networking #2952 replaced Gremlin Console–based detection with a lightweight PD REST health check, sidestepping the Jansi issue entirely [1].

4. Tracking — Issue [Improve] add macOS Apple Silicon smoke test for Gremlin Console #3015 tracks adding a dedicated macOS Apple Silicon smoke test for gremlin-console.sh in CI to catch this class of regression going forward [3].

There isn't yet an official upstream fix that ships an ARM64-compatible Jansi in the release tarball, but the issue is actively being tracked.

To reply, just mention @dosu.

---

Docs are dead. Just use Dosu.