Skip to content

CPU Compatibility

  • Check the release

    Confirm the binary matches the host platform.

  • Check the host

    Inspect the reported CPU or instruction error.

  • Get help

    Send the exact error and platform details.

A startup instruction error calls for checking the binary and the host.

You can confirm compatibility or give support the information needed to diagnose startup.

Next: System requirements

The distribution binary is built for compatibility mode, so it runs on a wide range of x64 and ARM64 CPUs. On very old hardware or restricted environments, you may see errors like:

  • Illegal instruction
  • SIGILL
  • Operation not supported (when the binary hits an unsupported CPU instruction)
  1. Verify the binary — run ./identity-scribe-* --version. If this fails, the CPU may not support the baseline instructions required by the compatibility build.

  2. Check your CPU — the compatibility target excludes newer instruction sets (e.g. AVX2, AVX-512). If you run on an older x64 CPU (pre-2011) or a constrained VM/container, you may hit limits.

  3. Workarounds:

    • Run on a host that meets the System requirements.
    • Make sure you run the binary that matches your target platform/architecture (for example, x64 vs ARM64).
    • If startup still fails, contact support and include the exact error output plus your platform details (uname -m, container base image, and virtualization environment).